Skip to content

ainola/swayimg

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Screenshot

Supported image formats

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

Packaging status

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

CI

The project uses Meson build system:

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

About

Image viewer for Sway/Wayland

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 92.7%
  • Roff 4.1%
  • Meson 3.0%
  • Shell 0.2%