PyComicsViewer - A Comic Viewer in Python
Features
license: GPL
opens *.cbr , *.cbz and *.cba compressed comic files
opens uncompressed directories
zooms images
rotate images
simple navigation through the comic using menus, toolbar and keyboard
bookmarks
thumbnail and file browser
logging
md5 and sfv file checking
more...
If you want some feature you think is nice to have and it is not implemented yet, leave me a note.
Maybe it'll become one of the new features from the next release ;)
Project on SourceForge
The project is currently hosted on SourceForge .
What's new?
Changes in 0.9.12 (2005/02/28)
hide the drawing mouse cursor if there is no
mouse activity there (keys will continue to work,
but for mouse pan to work, you'll need to first
move the mouse so the cursor reapear)
[bug] checksum summary was not computed correctly
[bug] windows SFV files were not parsed correctly
[bug] sfv checking was failing in some cases
Changes in 0.9.11 (2005/02/26)
added support for checking the md5 and sfv check-sums
added a progress bar to show the progress of thumbnail generation
show the version of the viewer in the main window title
(when there is no comic loaded) and in the About dialog
close the About dialog on ESC
changed the layout of the About a bit
made a multi-rezolution icon for windows
removed the test python files from the source and binary distributions
[bug] hopefully solved the crash that appeared when trying to
reload the comics while generating the thumbs
Changes in 0.9.10 (2005/02/20)
added logging system based on python's logging system and a tab in preferences to configure it
show the ReadMe window when other windows than the
pycomicsviewer.py are started directly.
close the application with the ESC key
show corectly the name of the current file on the status bar
solved bug that prevented the open of a comic after
trying to open a non-existing comic (using the history, for
example)
Changes in 0.9.9 (2005/02/17)
finished the implementation of panning and mouse navigation
added a thumb preview page to the browser
Changes in 0.9.8 (2005/02/14)
started to work on panning with the mouse
hopefully solved navigation bug with the keyboard
when the viewer didn't jump to the next image
support navigation with keypad keys and with the SPACE key
added bookmark support
added support for showing and hiding the browser
remember browser size after restart
Changes in 0.9.7 (2005/02/07)
added a navigation pane on the left side of the main window
launch decompressors with subprocess.Popen from Python2.4
made setup to work on Win$$, too (with VCToolkit 2003)
upgraded to Python2.4
Changes in 0.9.6 (2005/02/01)
the setup.py didn't work correctly in 0.9.5 .
renamed the starting script from pycomicsviewer to pycomicsviewer.py
Changes in 0.9.5 (2005/01/30)
solved rotation bug for images that have sizes not divizible by 4
set the size of the 'Open' dialog in the glade template, not
in the program
show the number of files detected so far during dir scanning
set UI to use tear-off menus
added code to sort files alfa-numerically (that is, the file
'5.jpg' will come before '10.jpg')
better installation support
Changes in 0.9.4 (2005/01/24)
added distutils support
added a LICENSE file
alternate C rotation implementations for GdkStrategy
solved restauration of the initial size and position even
when the viewer is closed when maximized or in fullscreen
pulse the progress during decompresion
display some text info during scanning the dir
refresh doesn't reset the current page
new stock icons and app icon
added code for the '...' buttons from the preferences dialog
Changes in 0.8.0 (2005/01/17)
corrected keyboard bugs
use only one glade template for all dialogs and windows
use only one open dialog that can open both files and folders
added a refresh button to reload the current archive
code clean-ups
Requirements
Python 2.4 or newer (if you
build and install yourself the viewer , you can also try to use the
Python 2.3 with the subprocess module )
PyGTK 2.4 or newer
PIL (optional)
C compiler and Python-Dev to compile CRotate (only if you build and install yourself the viewer )
Windows note:
I have tested and run the viewer on WindowsXP with SP2 only . But it should work
on other windows platforms, too.
If you don't have the python , python-gtk and gtk already installed, you'll need
to download and install them before runing the viewer.
For gtk, I am using the gladewin32
release. The python-gtk is from here .
Intallation
To install the viewer from sources you will
need, beside the run-time dependencies:
Installation uses the distutils module from python.
The installation can be tweaked in a couple of
ways:
--install-script controlls where the startup
script, pycomicsviewer.py , is installed
--install-lib controlls where the python code
and the compiled C modules are installed
--install-data controlls the place where
the data, the glade files and the images, are
installed
If you have both python2.3 and python2.4 installed, be sure you
call the setup with the correct python version!
Example 1
python setup.py install --prefix=/tmp/foo
does:
pycomicsviewer.py -> /tmp/foo/bin/pycomicsviewer.py
PyComicsViewer -> /tmp/foo/lib/python-2.3/site-packages/PyComicsViewer
glade & png's -> /tmp/foo/PyComicsViewer
Example 2
python setup.py install --install-scripts=/tmp/foo \
--install-lib=/tmp/foo --install-data=/tmp/foo
does:
pycomicsviewer.py -> /tmp/foo/pycomicsviewer.py
PyComicsViewer -> /tmp/foo/PyComicsViewer
glade & png's -> /tmp/foo/PyComicsViewer
Screenshots
Windows and Dialogs
Main Window (v0.9.11) - File Browser
Main Window (v0.9.11) - Thumbnail Browser
Main Window (v0.9.11) - MD5/SFV Sums
About Dialog (v0.9.11)
Preferences::Archivers (v0.7) Sets the paths to archivers and the command lines used to decompress the comics
Preferences::Color (v0.7) Sets the background color of the main window
Preferences::Logging (v0.9.10) Configures logging sub-system
ReadMe - Linux(v0.9.10) Shown when the user tries to start the viewer using the wrong python file
ReadMe - Windows(v0.9.10) Shown when the user tries to start the viewer using the wrong python file
Menus (v0.7)
Links
Other comics viewers:
Comics and XML: