command module
Version: v0.0.0-...-a270bbb Latest Latest

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

Go to latest
Published: Oct 28, 2020 License: GPL-3.0 Imports: 40 Imported by: 0



Small and simple image viewer written in pure Go.


  • Supports JPEG, PNG, GIF, BMP, PCX, TIFF, PBM, PGM, PPM, WEBP, PSD and TGA formats.
  • Scales images to window size and preserves aspect ratio.
  • Supports HTTP URLs passed as arguments.
  • Cross-platform (note: on macOS you need to install XQuartz).




go get -v github.com/gen2brain/goiv

This will install app in $GOPATH/bin/goiv.

Note: On Windows you need to generate manifest .syso file, use this instead:

go get github.com/akavel/rsrc

go get -d github.com/gen2brain/goiv
go generate github.com/gen2brain/goiv
go install github.com/gen2brain/goiv


  • j / Right / PageDown / Space

    Next image

  • k / Left / PageUp

    Previous image

  • f / F11


  • [ / ]

    Go 10 images back/forward

  • , / .

    Go to first/last image

  • q / Escape


  • Enter

    Print current image path to stdout

Example usage

  • View all images in a directory

    goiv /path/to/dir/*

  • View all JPEG's in all subdirectories

    find . -iname "*.jpg" | goiv

  • Delete current image when enter is pressed

    goiv * | xargs rm

  • Rotate current image when enter is pressed

    goiv * | xargs -i convert -rotate 90 {} {}

Planned features

  • draw in console on DRM/KMS and Framebuffer (partially implemented)
  • flip image vertically/horizontally
  • rotate image 90 degrees clockwise/counter-clockwise


The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL