imgview

command module
v0.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 8, 2024 License: GPL-3.0 Imports: 13 Imported by: 0

README

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

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

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
tagselection
TestIncludeExclude project main.go
TestIncludeExclude project main.go

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL