Small and simple image viewer.

• Platforms: Linux (X11, Wayland, DRM), Windows (Win32), macOS (Cocoa), BSDs (X11)
• Formats: JPEG, GIF, PNG, BMP, WEBP, AVIF, JXL, HEIC, ICO, PCX, TIFF, PNM/PBM/PGM/PPM, SVG, PSD, PSP, MPO, QOI, HDR, PFM, ICNS, XBM, XPM
• Animation: GIF, PNG, WEBP, AVIF, JXL, HEIC
• Auto-rotate: applies the EXIF orientation (JPEG, WEBP, AVIF)
• URLs: HTTP arguments, and image scraping from HTML pages
• Auto-reload: when the current image is modified or its directory changes
• Single instance: open files in an already-running window
• Clipboard: copy the current image, or its path, to the clipboard
• Self-contained: no external runtime dependencies, single static binary *

Download the latest binaries from the releases.

* Release binaries use CGO_ENABLED=0; Linux/BSD binaries are built with nodynamic tag (no libc). Note that without nodynamic even with CGO_ENABLED=0 the binary will still link to libc.

go install github.com/gen2brain/iv/cmd/iv@latest

This command will install iv in GOBIN, you can point GOBIN to e.g. /usr/local/bin or ~/.local/bin. Add -ldflags "-s -w" to strip debug symbols.

• minimal - build support only for JPEG, GIF and PNG (stdlib only)
• nodynamic - do not use system shared libraries (libwebp, libavif, libjxl, libheif)
• x11 - use X11 in macOS or Windows (e.g., via XQuartz or Xming)

Next image

• j / Right / Space / Scroll Down

Previous image

• k / Left / BackSpace / Scroll Up

Toggle Fullscreen

• f / F11 / Double-click

Toggle Slideshow

• s

Go 10 images back

• [ / PageUp

Go 10 images forward

• ] / PageDown

Go to the first image

• , / Home

Go to the last image

• . / End

Jump to image number

• <number> then G (e.g. 12G)

Zoom In, Zoom Out, Original Size, Fit

• + / Ctrl+Scroll Up, - / Ctrl+Scroll Down, Shift+9, Shift+0

Pan zoomed image

• Left / Middle drag

Adjust Contrast

• Shift+1, Shift+2

Adjust Brightness

• Shift+3, Shift+4

Adjust Gamma

• Shift+5, Shift+6

Adjust Saturation

• Shift+7, Shift+8

Rotate (clockwise / counterclockwise)

• r / Shift+r

Flip (horizontal / vertical)

• h / v

Cycle scaling filter (nearest / linear / bicubic)

• a

Cycle sort order (none / name / time / size / shuffle)

• o

Mark / unmark image (printed to stdout on quit)

• m

Toggle EXIF overlay

• i

Copy image path to clipboard

• Ctrl+c

Copy image to clipboard

• Ctrl+Shift+c

Quit

• q / Escape

Print current image path to stdout

• Enter

• View all images in a directory

  iv /media/images/

• View all JPEGs in all subdirectories

  find . -iname "*.jpg" | iv

• Delete current image when enter is pressed

  iv *.jpg | xargs rm -f

• Mark images with m, save the marked paths on quit

  iv *.jpg > keep.txt

• Rotate the current image when enter is pressed

  iv *.jpg | xargs -i convert -rotate 90 {} {}

Usage: iv [<flags>] [file1 dir1 url1 ... fileOrDirN]
  --width
    	Window width [IV_WIDTH]. (default "1024")
  --height
    	Window height [IV_HEIGHT]. (default "768")
  --device
    	DRM device index [IV_DEVICE]. (default "0")
  --filter
    	0=NearestNeighbor, 1=Linear, 2=Bicubic [IV_FILTER]. (default "0")
  --title
    	Show window title [IV_TITLE]. (default "true")
  --slideshow
    	Start slideshow [IV_SLIDESHOW]. (default "false")
  --slideshow-interval
    	Slideshow interval (in seconds) [IV_SLIDESHOW_INTERVAL]. (default "4")
  --recursive
    	Process subdirectories recursively [IV_RECURSIVE]. (default "false")
  --fullscreen
    	Start in fullscreen [IV_FULLSCREEN]. (default "false")
  --maximize
    	Start maximized [IV_MAXIMIZE]. (default "false")
  --browse
    	Load all images from the image directory [IV_BROWSE]. (default "true")
  --loop
    	Wrap around at the first/last image [IV_LOOP]. (default "false")
  --preload
    	Preload adjacent images (uses more memory) [IV_PRELOAD]. (default "false")
  --sort
    	0=No sort, 1=Name (natural order), 2=Modification time, 3=Size, 4=Shuffle [IV_SORT]. (default "0")
  --text-color
    	Text color [IV_TEXT_COLOR]. (default "#FFFFFF")
  --background-color
    	Window background color [IV_BACKGROUND_COLOR]. (default "#000000")
  --zoom
    	Initial zoom level (1, 1000) [IV_ZOOM]. (default "0")
  --contrast
    	Adjust contrast (-100, 100) [IV_CONTRAST]. (default "0")
  --brightness
    	Adjust brightness (-100, 100) [IV_BRIGHTNESS]. (default "0")
  --gamma
    	Adjust gamma (1, 100) [IV_GAMMA]. (default "100")
  --saturation
    	Adjust saturation (-100, 100) [IV_SATURATION]. (default "0")
  --single
    	Single instance; send files to a running window [IV_SINGLE]. (default "false")
  --wait
    	Open a blank window and wait for images (use with --single) [IV_WAIT]. (default "false")
  --help-keys
    	Show keybindings and exit. (default "false")

On Linux, you can also use IV_DRIVER env var, i.e. IV_DRIVER=x11 will force X11 compatibility mode on Wayland. To use a config file, create file $XDG_CONFIG_HOME/iv/config, see example.

runtime.LockOSThread()

view, err := iv.New()
if err != nil {
    panic(err)
}

view.Display(context.Background(), img)