swayimg(1)
swayimg is a lightweight image viewer for Wayland/Sway with keyboard-driven navigation and minimal dependencies.
Synopsis
swayimg [OPTIONS] [FILE|DIR]...Description
swayimg is an image viewer built for the Sway window manager and Wayland-based desktops. It displays images from files or directories with efficient memory usage and supports common image formats including PNG, JPEG, GIF, and WebP. The viewer uses keyboard shortcuts for navigation and can be used interactively or with command-line options.
Key features include slideshow mode, image scaling to fit window, recursive directory traversal, and a minimalist interface designed for keyboard control. It integrates well with tiling window managers and works natively under Wayland without X11 compatibility layers.
Common options
| Flag | What it does |
|---|---|
-h, --help | display help message and exit |
-v, --version | show version information |
-f, --fullscreen | open in fullscreen mode |
-s, --slideshow | start slideshow automatically on launch |
-t, --slideshow-interval | set slideshow interval in milliseconds (default: 3000) |
-r, --recursive | recursively load images from subdirectories |
-o, --order | sort images by name, size, date, or random |
--config | specify custom configuration file path |
Examples
open a single image file in the viewer
swayimg ~/Pictures/photo.jpgopen image viewer and load all images from the Pictures directory
swayimg ~/Picturesopen image in fullscreen mode
swayimg -f ~/Images/vacation.pngstart automatic slideshow with 2-second interval for all images in Pictures
swayimg -s -t 2000 ~/Picturesload images recursively from Media directory and all subdirectories
swayimg -r ~/Mediaload images sorted by modification date
swayimg --order date ~/Photosload images from current directory in random order
swayimg -o random .