https://github.com/kovidgoyal/iv

A simple image browser
https://github.com/kovidgoyal/iv

Last synced: 16 days ago
JSON representation

A simple image browser

• Host: GitHub
• URL: https://github.com/kovidgoyal/iv
• Owner: kovidgoyal
• License: gpl-3.0
• Created: 2016-10-03T04:05:48.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2022-04-01T14:24:27.000Z (over 2 years ago)
• Last Synced: 2024-10-19T22:52:46.517Z (24 days ago)
• Language: Python
• Size: 56.6 KB
• Stars: 40
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
iv -- Image Viewer

=========================

A simple image viewer that can recursively display images from directories in a

grid. Click on any image to display it full size. Auto-reloads images if

they are changed on disk.

Supports all image formats used on the web including animated GIFs and SVG.

Uses a browser engine (chromium) to do the rendering, so its format support

will always be current.

Dependencies

==============

* python >= 3.5

* PyQt >= 5.7

* rapydscript-ng >= 0.7.9

Installation

==============

Simply clone this repository and run it using

```

python3 /path/to/cloned/repository /path/to/image/directory

```

Controls

===========

`iv` is largely keyboard controlled. The keyboard shortcuts in the two views are:

Grid View

-------------

* `c` - Toggle the captions

* `+` - Increase thumbnail size

* `-` - Decrease thumbnail size

* `0` - Reset thumbnail size to default

* `r`, `F5` - Reload all thumbnails

* `j` - Scroll down

* `k` - Scroll up

Single Image View

-------------------

* `c` - Toggle the information display

* `+` - Zoom in

* `-` - Zoom out

* `0` - Reset zoom to no zoom

* `r`, `F5` - Reload image

* `Esc` - Go back to the grid view

* `Space`, `Right`, `Down`, `Pagedown`, `j` - Show next image

* `Backspace`, `Left`, `Up`, `Pageup`, `k` - Show previous image