Swayimg: image viewer for Sway/Wayland

Swayimg is a lightweight image viewer for Wayland display servers.

In a Sway compatible mode, the viewer creates an "overlay" above the currently active window, which gives the illusion that you are opening the image directly in a terminal window.

Supported image formats

• JPEG (via libjpeg);
• JPEG XL (via libjxl);
• PNG (via libpng);
• GIF (via giflib);
• SVG (via librsvg);
• WebP (via libwebp);
• HEIF/AVIF (via libheif);
• TIFF (via libtiff);
• BMP (built-in).

Usage

swayimg [OPTIONS]... [FILE]...

See man swayimg for details.

Examples:

• View multiple files:

  swayimg photo.jpg logo.png
  

• View all files (recursively) in the current directory in random order:

  swayimg --recursive --order=random
  

• View using pipes:

  wget -O- https://www.kernel.org/theme/images/logos/tux.png 2>/dev/null | swayimg -
  

• View, mark, and remove all marked files in the current directory:

  swayimg --mark | xargs -d '\n' rm
  

Key bindings

Key	Action
Arrows and vim-like moving keys (hjkl)	Move view point
+ or =	Zoom in
-	Zoom out
0	Set scale to 100%
Backspace	Reset position and scale to defaults
F5 or [	Rotate 90 degrees anticlockwise
F6 or ]	Rotate 90 degrees clockwise
F7	Flip vertical
F8	Flip horizontal
i	Show/hide image properties
F11 or f	Toggle full screen mode
PgDown, Space, or n	Open next file
PgUp or p	Open previous file
N	Open file from next directory
P	Open file from previous directory
Home or g	Open the first file
End or G	Open the last file
F2 or O	Show previous frame
F3 or o	Show next frame
F4 or s	Start/stop animation
F9	Start/stop slideshow mode
Insert or m	Invert mark sate for current file
* or M	Invert mark sate for all files
a	Mark all files
A	Unmark all files
Esc, Enter, F10 or q	Exit the program

Configuration

The viewer searches for the configuration file with name config in the following directories:

• $XDG_CONFIG_HOME/swayimg
• $HOME/.config/swayimg
• $XDG_CONFIG_DIRS/swayimg
• /etc/xdg/swayimg

Sample file is available here.

See man swayimgrc for details.

Install

List of supported distributives can be found on the Repology page.

Arch users can install the program from community repository: swayimg or from AUR swayimg-git package.

Build

The project uses Meson build system:

meson build
ninja -C build
sudo ninja -C build install