imgview

README

Simple image viewer with gallery feature + archive support

Website: https://imgview.app

The gallery positions the images with consideration to landscape or portrait orientation.
I like it. I think it gives a good overview of the pictures.
Next step will be to do something with the background/white space.

It can read most common archive formats - such as zip, rar, tar, cbr, etc.

It loads relatively fast on my computer, but zoom and reposition is unfortunatly rather slow on high resolution pictures :-/

Download precompiled binary

Latest build: 2022-07-09

• Imgview for Linux X11: Download
• Imgview for Windows: Download (Windows is untested)
• I do not provide binaries for Apple Operating systems, since I do not agree with the Xcode license terms. That said, imgview probably works if you compile it yourself.

Just download and remember to make it executable.

TODO (report bugs and wishes)

Here

Build

Imgview is written in Go, and made using the excellent fyne GUI framework, which in turn depends on cgo - see details here
When you have a C compiler and the dependencies of fyne installed, then compiling imgview is very straight forward.

git clone https://git.sr.ht/~uid/imgview
cd imgview
go build # -tags wayland # for building on wayland
go install # to install to $GOPATH/bin

Or alternatively

go install git.sr.ht/~uid/imgview

Run

imgview /path/to/img/or/dir/or/archive

Default Key Bindings

Change by copying config.toml to:
Linux: ~/.config/imgview/config.toml
Windows: %AppData%\imgview\config.toml
and then edit to your liking :-)

In gallery mode

Key	Action
Q	Quit
Esc	Quit
Down/J	Scroll down
Up/K	Scroll up

In single picture mode

Key	Action
Esc	Go back to gallery
Right/J	Next picture
Left/K	Previous picture
Up/H	Rotate left
Down/L	Rotate right
X	Fit to window
B	Switch filtering mode
S	Zoom to original size
F	Fullscreen (fails on wayland)

Mouse	Action
Scroll down	Zoom in
Scroll up	Zoom out
Drag	Reposition image