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);
AV1F/AVIFS (via libavif);
TIFF (via libtiff);
EXR (via OpenEXR);
BMP (built-in);
PNM (built-in);
TGA (built-in).

Usage

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

See man swayimg for details.

Examples:

View multiple files:
```
swayimg photo.jpg logo.png
```
Start slideshow for all files (recursively) in the current directory in random order:
```
swayimg --slideshow --recursive --order=random
```

View using pipes:

wget -qO- https://www.kernel.org/theme/images/logos/tux.png | swayimg -

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 or locally /usr/share/swayimg/swayimgrc.

See man swayimgrc for details.

Install

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

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

Build

The project uses Meson build system: