Skip to content
Viewer for comic book archives that aims at convenience and simplicity
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data Updated Finnish translation. May 30, 2012
help
i18n Quick and dirty Qt5 port. Yes we can. Apr 4, 2015
setup/gui
src Fatal if temporary dir cannot be created. Nov 22, 2016
.gitignore
AUTHORS
CMakeLists.txt
COPYING QComicBook - Poczatkowy uklad repozytorium Mar 28, 2005
ChangeLog
Doxyfile Added Doxygen config, bgeinning of class documentation. Oct 10, 2010
NEWS QComicBook - Poczatkowy uklad repozytorium Mar 28, 2005
README Quick and dirty Qt5 port. Yes we can. Apr 4, 2015
README-translations Added translation guidelines. Jul 3, 2010
THANKS
TODO Added some ideads Oct 10, 2011
header Wprowadzenie strategii dla obslugi programow archiwizujacych. Aug 22, 2009
snapcraft.yaml Use desktop-qt5 instead of desktop/qt5 to workaround lp: #1607015 Aug 16, 2016

README

QComicBook
(c)by Pawel Stolowski 2005-2012
released under terms of GNU General Public License v2

1. Introduction
---------------
QComicBook is a viewer for PDF files and comic book archives containing
jpeg/png/xpm/gif/bmp images, which aims at convenience and simplicity.
Features include: automatic unpacking of archive files, full-screen mode, continuous
scrolling mode, double-pages viewing, manga mode, thumbnails view, page scaling,
mouse or keyboard navigation etc.

2. Requirements
---------------
QComicBook requires Qt libraries version >=5.4.0 (qtcore, qtwidgets, qtprintsupport,
qtx11extras, qtprintsupport), poppler-qt5 library and cmake.

You will also need unzip, rar (or unrar), unace, p7zip and tar (with gzip and
bzip2 support compiled in) somewhere in your PATH to handle archives. If one of
these tools is missing you can still use QComicBook, but you won't be able to
open some archives. You may check status of supported archives via Help > System information
menu option of QComicBook.

3. Installation
---------------
To compile QComicBook, you will need Qt4 developement packages (usually named
-devel- in many distros) and libpoppler-qt4 devel package.
Compilation includes three steps:

$ cmake . -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release
$ make
$ make install
(the -D... argument is optional; if not specified, qcomicbook will be installed in
/usr/local directory).

If you want to compile qcomicbook with e.g. /usr prefix, but install it to a temporary
location for packaging, then pass DESTDIR variable to 'make install', e.g.
$ make install DESTDIR=/tmp/package_root

4. Known issues
---------------
* rar/unrar (and unzip/unace probably too) may have problems with files/dirs in the
archive, which names contain non-ascii characters (like special characters for you
language). As a result they won't be decompressed and qcomicbook may show
"No images found" error box.
* the free (opensource) unrar doesn't currently support 3.0 rar archives. Such archives are reported
as empty by QComicBook. It is *recommended* to use non-free rar/unrar.

5. Bugs
-------
Ideally, your bug report should include:
- description of problem.
- list of steps that reproduce the problem (if it's reproducible).
- console output from QComicBook (recompile QComicBook with -DCMAKE_BUILD_TYPE=Debug flag to enable debug
  messages).
- sample comic book archive that causes problems if problem is only reproducible with particular archive.
  Please reduce the number of images in the archive to the minimum needed for reproducing bug.

Please report bugs to: stolowski@gmail.com.

6. Translations
---------------
If you want to translate QComicBook, please read README-translations.
You can’t perform that action at this time.