artemsen / swayimg

Swayimg: image viewer for Wayland and DRM Swayimg is a lightweight Wayland-native image viewer optimized for the Sway and Hyprland window managers, featuring an overlay mode that simulates terminal image display. The application supports slideshow and gallery modes, reads from stdin and external commands, and is highly customizable via Lua scripting. • Support for the most popular image formats: • JPEG (via libjpeg), • JPEG XL (via libjxl); • PNG (via libpng); • GIF (via giflib); • SVG (via librsvg); • WebP (via libwebp); • HEIF/HEIC (via libheif); • AV1F/AVIFS (via libavif); • TIFF (via libtiff); • Sixel (via libsixel); • Raw: CRW/CR2, NEF, RAF, etc (via libraw); • EXR (via OpenEXR); • BMP (built-in); • PNM (built-in); • TGA (built-in); • QOI (built-in); • DICOM (built-in); • Farbfeld (built-in). • Gallery and viewer modes with slideshow and animation support; • Loading images from files and pipes; • Preload images in a separate thread; • Fully customizable keyboard bindings, colors, and many other parameters via Lua bindings. Usage Examples: • View multiple files: • View using pipes: • Loading stdout from external commands: See full documentation for details. Configuration The Swayimg configuration file is a Lua script. The full list of available functions is described in the documentation and in the Lua source file. Example of the configuration file is available after installation in . Install List of supported distributives can be found on the Repology page. Arch users can install the program from the extra repository or from AUR package. Build The project uses Meson build system: