| Name | image-archive-viewer JSON |
| Version |
0.4.1
JSON |
| download |
| home_page | None |
| Summary | ComicView: an image archive (ZIP, RAR, CBR, CBZ) viewer written in Python and Qt |
| upload_time | 2025-08-04 18:54:01 |
| maintainer | None |
| docs_url | None |
| author | CaptSolo |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
image viewer
qt
zip archives
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# ComicView: Image Archive Viewer
ComicView is an 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 image 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
### Compatibility
ComicView works with:
- Linux
- macOS
- Microsoft Windows
### Prerequisites
- Python 3.8 or higher
- unrar (for reading CBR and RAR files)
### Dependencies
- PyQt5
- Pillow
- rarfile (for reading CBR and RAR files)
The application will fail reading CBR and RAR files if `unrar` is not installed.
- for macOS and Linux: `unrar` can be installed using a package manager (e.g. Homebrew on macOS)
- for Windows: download `unrar` from the [RARLab site](https://www.rarlab.com/rar_add.htm) and put it in a folder on the system search PATH.
### Install from PyPI
You can install `ComicView` as a `uv` tool and then run it directly from shell:
```
uv tool install image-archive-viewer
```
The application installed this way will be available globally on the command line.
This installation method requires the [uv package manager](https://docs.astral.sh/uv/) for Python.
You can also install `ComicView` using `pip` or `uv pip` command, typically inside a Python virtual environment:
```
pip install image-archive-viewer
```
Using `uv pip`:
```
uv pip install image-archive-viewer
```
## Usage
After installation, run the viewer:
```bash
comic_view
```
You will be prompted to select a comic book or archive 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
## 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](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "image-archive-viewer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "Image viewer, Qt, ZIP archives",
"author": "CaptSolo",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/76/7a/0402da462f457f46bc7ec5248199c9f345f10bd82b72b86421ab4dc27d30/image_archive_viewer-0.4.1.tar.gz",
"platform": null,
"description": "# ComicView: Image Archive Viewer\n\nComicView is an 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.\n\nThis image archive viewer is built in Python and uses Qt for its user interface. \n\nIt can be used for viewing comic books, photo collections, or any image archives.\n\n## Features\n\n- View images from ZIP, RAR, CBR and CBZ archives (PNG, JPG)\n- Fullscreen view\n- Mouse and keyboard navigation\n- Zoom and pan with mouse or keyboard\n\nThe list of files in the archive is sorted alphabetically upon loading.\n\nTo see help in the application press \"H\" at any time.\n\n## Supported Formats\n\n### Archive Formats\n\n- **CBR files** (`.cbr`) - Comic Book RAR files\n- **CBZ files** (`.cbz`) - Comic Book ZIP files\n- **RAR files** (`.rar`) - RAR archives\n- **ZIP files** (`.zip`) - ZIP archives\n\n### Image Formats\n\n- PNG (`.png`)\n- JPEG (`.jpg`, `.jpeg`)\n\n## Installation\n\n### Compatibility\n\nComicView works with:\n- Linux\n- macOS\n- Microsoft Windows\n\n### Prerequisites\n\n- Python 3.8 or higher\n- unrar (for reading CBR and RAR files)\n\n### Dependencies\n\n- PyQt5\n- Pillow\n- rarfile (for reading CBR and RAR files)\n\nThe application will fail reading CBR and RAR files if `unrar` is not installed.\n- for macOS and Linux: `unrar` can be installed using a package manager (e.g. Homebrew on macOS)\n- for Windows: download `unrar` from the [RARLab site](https://www.rarlab.com/rar_add.htm) and put it in a folder on the system search PATH.\n\n### Install from PyPI\n\nYou can install `ComicView` as a `uv` tool and then run it directly from shell:\n\n```\nuv tool install image-archive-viewer\n```\n\nThe application installed this way will be available globally on the command line.\nThis installation method requires the [uv package manager](https://docs.astral.sh/uv/) for Python.\n\nYou can also install `ComicView` using `pip` or `uv pip` command, typically inside a Python virtual environment:\n\n```\npip install image-archive-viewer\n```\n\nUsing `uv pip`:\n\n```\nuv pip install image-archive-viewer\n```\n\n## Usage\n\nAfter installation, run the viewer:\n\n```bash\ncomic_view\n```\n\nYou will be prompted to select a comic book or archive file containing images. The viewer will open in a fullscreen mode.\n\n## Controls\n\n### Navigation\n- **Right Arrow** or **Space**: Next image\n- **Left Arrow**: Previous image\n- **Q** or **Esc**: Quit\n\n### Zoom\n- **+** or **=**: Zoom in\n- **-**: Zoom out\n- **0**: Reset zoom to fit window\n- **Mouse wheel**: Zoom in/out (centered on cursor)\n\n### Panning\n- **W**: Pan down\n- **S**: Pan up\n- **A**: Pan right\n- **D**: Pan left\n- **Mouse drag**: Pan image (when zoomed in)\n\n### Other\n- **H**: Show/hide help information \n- **O**: Open a new archive file\n\n## Tips\n\n- Press **H** anytime to see a help screen with all available controls\n- Use **0** to quickly reset zoom and fit the image to the window\n- The mouse wheel zooms centered on your cursor position for precise control\n- When zoomed in, you can drag with the mouse to pan around the image\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "ComicView: an image archive (ZIP, RAR, CBR, CBZ) viewer written in Python and Qt",
"version": "0.4.1",
"project_urls": {
"homepage": "https://github.com/CaptSolo/image-archive-viewer/"
},
"split_keywords": [
"image viewer",
" qt",
" zip archives"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c9a59850ef8df41fd0326e24f907934faf82f60411e3723c907870e90203c34b",
"md5": "ed38811f67b61d09d87df519e848ada7",
"sha256": "46d840f8baabbbf50a468019e4cddaf2b8f88ee8b5878fdce91b9f9556211695"
},
"downloads": -1,
"filename": "image_archive_viewer-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ed38811f67b61d09d87df519e848ada7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 9703,
"upload_time": "2025-08-04T18:54:00",
"upload_time_iso_8601": "2025-08-04T18:54:00.190710Z",
"url": "https://files.pythonhosted.org/packages/c9/a5/9850ef8df41fd0326e24f907934faf82f60411e3723c907870e90203c34b/image_archive_viewer-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "767a0402da462f457f46bc7ec5248199c9f345f10bd82b72b86421ab4dc27d30",
"md5": "8a06d2cc9a48759c9ee7b619c1453c85",
"sha256": "7138ee9f809d94100559a47d5c5da361d4a8e0f4cba90c668dbd1a63d03ecbda"
},
"downloads": -1,
"filename": "image_archive_viewer-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "8a06d2cc9a48759c9ee7b619c1453c85",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 68865,
"upload_time": "2025-08-04T18:54:01",
"upload_time_iso_8601": "2025-08-04T18:54:01.377768Z",
"url": "https://files.pythonhosted.org/packages/76/7a/0402da462f457f46bc7ec5248199c9f345f10bd82b72b86421ab4dc27d30/image_archive_viewer-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-04 18:54:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "CaptSolo",
"github_project": "image-archive-viewer",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "image-archive-viewer"
}
