Metadata-Version: 2.4
Name: jaggimage-viewer
Version: 1.1.3
Summary: A nice image viewer in the spirit of ACDSee
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: pyqt5>=5.15.11
Description-Content-Type: text/markdown

# jaggimage-viewer
I was so used to my 25+ years old version of ACDSee to quickly see my files, i just made my own image viewer with Python and Qt.

![Screenshot. Jaguar picture by Charles J. Sharp on Wikipedia](https://raw.githubusercontent.com/clxjaguar/jaggimage-viewer/main/media/screenshot.jpg)

## Usage

- You can run it without argument in any directory containing pictures, it will show the first of files with any recognized extension, and next/prev will show others files in current directory
- You can run it with one file name as argument to display it (or associate jaggimage-viewer with images files), next/prev will also show others files of the same directory
- You can run it with several files as argument, the first one will be displayed, next/prev will show others images you listed

## Shortcuts

Most keyboard shortcuts are shown in the contextual menu (right click), but some functions have several. I tried to keep the sames shortcuts than ACDSee.

| Shortcut(s)                                              | Functionality                                                            |
|----------------------------------------------------------|--------------------------------------------------------------------------|
| `Space`, `Page Down`, Scroll wheel                       | Next image                                                               |
| `Backspace`, `Page Up`, Scroll wheel                     | Previous image                                                           |
| `Home`                                                   | First image                                                              |
| `End`                                                    | Last image                                                               |
| `+`, `Ctrl`/`Shift` + Scroll wheel                       | Zoom in                                                                  |
| `-`, `Ctrl`/`Shift` + Scroll wheel                       | Zoom out                                                                 |
| `/`                                                      | Zoom 1:1 ("pixel perfect")                                               |
| `*`                                                      | Toggle zoom best-fit / full width or height                              |
| `Ctrl`+`/`                                               | Toggle zoom lock (zoom level not changing when displaying another image) |
| `F`, `F11`, Double-click                                 | Toggle full-screen mode                                                  |
| `B`                                                      | Toggle status bar                                                        |
| `Ctrl+D`                                                 | Edit file description                                                    |
| Arrows keys (with `Ctrl`: faster, with `Shift`: slower)  | Panning image (if not zoomed best fit)                                   |
| `Alt`+`←` and `Alt`+`→`                                  | Rotating image view                                                      |
| `F2`                                                     | Rename file (and .txt description file, if present)                      |
| `Del`                                                    | Delete current file (and display next image)                             |
| `F5`                                                     | Reload file and relist directory                                         |
| `F10`                                                    | Show contextual menu                                                     |
| `Ctrl`+`O`                                               | Open a specific file (in same or different directory)                    |
| `Ctrl`+`C`                                               | Copy current image to clipboard                                          |
| `Ctrl`+`E`                                               | Open the image with an external editor (gimp by default)                 |
| `Escape`, `Ctrl`+`W` (and probably `Alt`+`F4` too)       | Quit the program                                                         |

## Installation

### From PyPI

This assumes you have either `Python` and `pip`, or `uv` installed.

With `pip`:

```shell
pip install jaggimage-viewer
```

With `uv`:

```shell
uv tool install jaggimage-viewer
```

### From sources

1. Have `uv` installed: https://docs.astral.sh/uv/#installation
1. Clone the repository:

    ```shell
    git clone https://github.com/clxjaguar/jaggimage-viewer.git
    ```

1. Run the installation:

    ```shell
    cd jaggimage-viewer
    uv build
    uv tool install .
    ```
