QCOMICBOOK(1)

🎀 NAME 🎀

QComicBook — a QT viewer for comic book archives (cbr/cbz). 💖

---

📖 SYNOPSIS 📖

qcomicbook [archive] [dir] ...

---

✨ DESCRIPTION ✨

okay so bestie, picture this: QComicBook is a viewer for comic book archives stuffed with jpeg/png/xpm/gif images, and its whole entire personality is convenience and simplicity. no bloat, no drama, just comics. 🦋

Features include:

• automatic decompression of zip (cbz), rar (cbr), ace (cba), targzipped (cbg) and tarbzip2ped (cbb) archives 💅
• full-screen mode
• two-pages viewing
• page scaling
• mouse or keyboard navigation
• bookmarks
• thumbnails
• page caching and page preloading
• ... and more

QComicBook software requirements:

• rar/unrar (one of them), unzip, unace and tar (with gzip and bzip2 support compiled-in) available somewhere in the PATH (e.g. in /usr/bin). If one of them is missing, you won't be able to open some archives 😭
• a lot of disk space available in /tmp directory, for handling decompression of archives

---

🌈 MENU 🌈

📁 File

The File menu is your home base, fr fr — it provides basic operations for loading comic books:

• Open directory — open a directory containing images.
• Open archive — open archived images.
• Recently opened — a list of ten recently opened archives / directories (most recently opened on the top).
• Info — displays information about the currently opened comic book. This includes contents of file_id.diz, *.nf o files (if any) as well as memory usage info.
• Settings — lets you fine-tune some options.
• Close — closes the currently opened comic book.
• Quit — quits QComicBook.

QComicBook offers some tunable options, available via the Settings menu option. These options include:

• Background color — the color of the empty area around the displayed image.
• Hide menubar in fullscreen mode — the menubar may be hidden in fullscreen mode if desired; together with the toolbar hiding option, it may give you the whole screen for displaying page contents.
• Hide statusbar in fullscreen mode — the statusbar may be hidden in fullscreen mode, giving you even more space.
• Small mouse cursor — toggles a small (4x4 pixels) mouse cursor for the QComicBook window.
• Scaling method — the algorithm used for image scaling; either Smooth or Fast. Smooth scaling provides the best quality, but is slower; it is the recommended method unless you have a really slow machine.
• Cache size — the number of pages kept in memory. Value of 0 disables caching; 1 has no effect on performance; 2 or more may improve your experience. Keep in mind that caching may consume a lot of memory — for example, an 1280x1984 image may take as much as 9Mb of memory!
• Preload next page — enables page preloading in the background. This setting takes effect only for cache size of 3 and greater. It is recommended to enable this option, as it may really improve the overall experience.
• Use disk cache for thumbnails — thumbnails are saved to disk, which speeds things up when loading them later. Set this option on if you tend to open comic books more than once.
• Number of days to keep thumbnails — defines, for how long to keep thumbnails on disk; old thumbnails are deleted when exiting QComicBook. Value of 0 disables purging.
• Help browser — allows you to choose between the simple built-in browser (the default) or any other external web browser.
• Forward and backward two pages in two-pages mode.
• Open info dialog after opening comic book — when enabled, the info dialog is opened after opening a comic book. You may still open this dialog manually with the File/Info menu option.
• Confirm exit.

Note: changing cache size takes effect on new comic book.

👀 View

The View submenu provides some basic settings for page view. 👑

You can select one of the following scaling modes:

• Original size — no scaling is done and the original image size is preserved.
• Fit width — image is scaled to fit window width.
• Fit height — image is scaled to fit window height.
• Whole page — image is scaled to fit the window.
• Best fit — depending on image dimensions, QComicBook chooses the best method to scale the image.

The page can be rotated with a 90 degree step, with these options:

• Rotate right — rotates the image clockwise.
• Rotate left — rotates the image counter clockwise.
• No rotation — resets rotation, restores the original image.
• Preserve rotation — makes rotation "permanent" for viewing next pages.

Other options in this menu:

• Fullscreen — toggles between fullscreen and windowed mode; please note, that depending on your settings, the menubar may be hidden in fullscreen mode, so to get back to windowed mode you need to press F11 or ESC key.
• Two pages — display two pages, side by side, just like when reading a normal book.
• Japanese mode — scrolls to the top-right corner on page change; in two pages mode it additionally swaps pages.
• Thumbnails — toggles the thumbnails window.
• Scrollbars — toggles displaying of scrollbars for large pages; please note that scrollbars will be shown only if necessary.
• Toolbar — toggles displaying of the toolbar.
• Statusbar — toggles displaying of the statusbar.

Settings in this menu are saved when quitting QComicBook (except for the "fullscreen" option). 💾

🔖 Bookmarks

The Bookmarks menu allows you to bookmark pages in comic books. These bookmarks are however somewhat different than, for example, in any webbrowser, and are more similar to real bookmarks. Each bookmark keeps the bookmarked page number (as well as file name), so you can easily start your comic book from the point where you last stopped reading. 🥹

Two options are available in this menu:

• Set bookmark for this comicbook — creates a bookmark for the current comic book; an existing bookmark for this comic book is deleted.
• Remove bookmark for this comicbook — removes an existing bookmark for the current comic book; to remove other bookmarks, use the Manage bookmarks option.
• Manage bookmarks — opens the bookmark manager, where bookmarks can be easily removed.

Below these options you can see the list of currently saved bookmarks. Just click on one of them to go to the bookmarked comic book and page. ✨

---

⌨️ KEYBOARD ⌨️

Keyboard reference:

• Ctrl+O — Open archive
• Ctrl+D — Open directory
• Alt+I — Show comicbook info
• Arrows — Scroll page contents
• Shift + Arrows — Scroll page contents fast
• PageDown — Go to next page
• PageUp — Go to previous page
• Home — Scroll to page top
• End — Scroll to page bottom
• Space — Scroll down by visible width (hint: enable continuous scrolling to jump to next page after reaching bottom)
• Backspace — Scroll up by visible width (hint: enable continuous scrolling)
• Alt+O — Original image size
• Alt+W — Fit page width
• Alt+H — Fit page height
• Alt+A — Show whole page
• Alt+B — Best fit
• Alt+T — Toggle thumbnails window
• F11 — Toggle fullscreen mode
• ESC — Exit fullscreen mode

---

🧠 INTERNALS 🧠

Here's some info for the people who are genuinely obsessed with QComicBook internals. 🫶

1. Settings handling

QComicBook keeps settings in the ~/.qcomicbook directory within these two files:

• qcomicbookrc — main configuration file
• bookmarks — bookmarks file

Both files are plain text files and may be edited manually (with caution!), if needed.

2. Thumbnails handling

Thumbnails are stored (if thumbnails disk caching is enabled) in the ~/.qcomicbook/cache directory.

3. Archives handling

Archived comic books are decompressed to a temporary directory (/tmp/qcomicbook-XXXXX, with XXXXX being some random number). This directory is purged when closing the current comic book, opening a new one or quitting QComicBook.

---

💖 AUTHOR 💖

QComicBook was written by Pawel Stolowski <pawel.stolowski@wp.pl>.

This manual page was written by Michal Pena (Cyb.org) <mp@horisone.com>, for the Debian project (but may be used by others).

---

and that's the whole vibe check, bestie — this was the QCOMICBOOK(1) page, written july 31, 2005 by Michal Pena (Cyb.org). go read some comics. periodt. 💅🎀🦋