Metadata-Version: 2.4
Name: image-archive-viewer
Version: 0.2.4
Summary: A simple image archive (ZIP) viewer
Project-URL: homepage, https://github.com/CaptSolo/image-archive-viewer/
Author: CaptSolo
License: MIT
License-File: LICENSE
Keywords: Image viewer,Qt,ZIP archives
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.8
Requires-Dist: pillow
Requires-Dist: pyqt5
Description-Content-Type: text/markdown

# Image Archive Viewer

A simple image archive (ZIP) viewer. Open a ZIP file 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.

## Features

- View images from ZIP archives (PNG, JPG)
- Fullscreen view
- Mouse and keyboard navigation
- Zoom and pan with mouse or keyboard

To see help in the application press "H".

## Installation

### Prerequisites

- Python 3.8 or higher

### Dependencies

- PyQt5
- Pillow

### 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:

```bash
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
- **Mouse wheel**: Zoom in/out

### 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 ZIP file

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
