A simple image archive (ZIP, RAR, CBR, CBZ) viewer written in Python and Qt
Project description
Image Archive Viewer
A simple image archive viewer for ZIP, RAR, CBR and CBZ files. Open archive files containing images and browse them in a fullscreen mode with a keyboard- and mouse-friendly user interface.
This archive viewer is built in Python and uses Qt for its user interface.
It can be used for viewing comic books, photo collections, or any image archives.
Features
- View images from ZIP, RAR, CBR and CBZ archives (PNG, JPG)
- Fullscreen view
- Mouse and keyboard navigation
- Zoom and pan with mouse or keyboard
The list of files in the archive is sorted alphabetically upon loading.
To see help in the application press "H" at any time.
Supported Formats
Archive Formats
- CBR files (
.cbr) - Comic Book RAR files - CBZ files (
.cbz) - Comic Book ZIP files - RAR files (
.rar) - RAR archives - ZIP files (
.zip) - ZIP archives
Image Formats
- PNG (
.png) - JPEG (
.jpg,.jpeg)
Installation
Prerequisites
- Python 3.8 or higher
- unrar (for reading CBR and RAR files)
Dependencies
- PyQt5
- Pillow
- rarfile (for reading CBR and RAR files)
Install from PyPI
To install this tool run:
pip install image-archive-viewer
Using uv:
uv pip install image-archive-viewer
You can also install it as a uv tool and then run it directly from shell:
uv tool install image-archive-viewer
Usage
After installation, run the viewer:
show_images
You will be prompted to select a ZIP file containing images. The viewer will open in a fullscreen mode.
Controls
Navigation
- Right Arrow or Space: Next image
- Left Arrow: Previous image
- Q or Esc: Quit
Zoom
- + or =: Zoom in
- -: Zoom out
- 0: Reset zoom to fit window
- Mouse wheel: Zoom in/out (centered on cursor)
Panning
- W: Pan down
- S: Pan up
- A: Pan right
- D: Pan left
- Mouse drag: Pan image (when zoomed in)
Other
- H: Show/hide help information
- O: Open a new archive file (ZIP or CBZ)
Tips
- Press H anytime to see a help screen with all available controls
- Use 0 to quickly reset zoom and fit the image to the window
- The mouse wheel zooms centered on your cursor position for precise control
- When zoomed in, you can drag with the mouse to pan around the image
License
This project is licensed under the MIT License - see the LICENSE file for details.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file image_archive_viewer-0.3.2.tar.gz.
File metadata
- Download URL: image_archive_viewer-0.3.2.tar.gz
- Upload date:
- Size: 31.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.6.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
536e60e2a98c6dc633f5c64cb6773d5bc568e9572214edc69a2d4c6ebf02b0d0
|
|
| MD5 |
fe87d8aa2c84c7330b59095cdc8ae60b
|
|
| BLAKE2b-256 |
c0d26117f5b0d1954d5d62dd2fae42e0b60d27105260b70bddfa0a242f5b3ed0
|
File details
Details for the file image_archive_viewer-0.3.2-py3-none-any.whl.
File metadata
- Download URL: image_archive_viewer-0.3.2-py3-none-any.whl
- Upload date:
- Size: 8.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.6.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
46a875a341107c593087dc13a7b5a9f0ce4587f22e14ac7da1f8c7e409beec32
|
|
| MD5 |
74cc8627cb1ad7f6f7d9b9201d5a43de
|
|
| BLAKE2b-256 |
d62c7f6dbb651b9e8e808e0be504cf0d6febe51031482dc64516fedba7f4856d
|
