NAME

       swayimg - lightweight image viewer for Wayland display servers

SYNOPSIS

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

DESCRIPTION

       If  no  input files or directories are specified, the viewer will try to read all files in
       the current directory.

       Use '-' as FILE to read image data from stdin.

       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. The program uses sway's IPC to determine the geometry  of  the  currently  focused
       workspace  and  window.  This  data  is  used  to calculate the position and size of a new
       window. Then the program adds two rules to the sway application swayimg: "floating enable"
       and  "move  position".  This  creates  a  new  Wayland  window and draws an image from the
       specified file.

OPTIONS

       -h, --help
              Display help message.

       -v, --version
              Display version information and list of supported image formats.

       -o, --order=ORDER:
              Set the order of the image file list:
              none: unsorted;
              alpha: sorted alphabetically (default);
              random: randomize list.

       -r, --recursive
              Read directories recursively.

       -a, --all
              Always open all files in the same directory. Even if you specify FILE
              as a path to some file (not a directory), swayimg will add all files
              in that directory to the image list.

       -l, --slideshow
              Activate slideshow mode on startup.

       -g, --geometry=X,Y,WIDTH,HEIGHT
              Set the absolute position and size of the window. For example, 10,20,100,200
              creates a window at position 10x20 (top left corner) with a size of
              100x200. The comma can be replaced with any non-numeric character. If this
              parameter is not specified, the geometry of the currently focused window
              will be used.

       -b, --background=XXXXXX
              Set background for transparent images:
              none: transparent;
              grid: show grid as background (default);

       -w, --window=XXXXXX
              Set window background:
              none: transparent (default);
              #XXXXXX: hexadecimal RGB color.

       -f, --fullscreen
              Start in full screen mode.

       -s, --scale=SCALE
              Set the default scale of the image. SCALE is one of the named values.
              optimal: reduce the image to fit the window, but do not enlarge it;
              fit: reduce or enlarge the image to fit the window;
              real: real image size (100%).

       -i, --info
              Show image meta info (file name, size, EXIF, current scale, etc).

       -e, --exec
              Set a command to be executed when the corresponding key is pressed, use % for
              image path, default is "echo '%'".

       -c, --class
              Set a constant window class/app_id. Setting this may break the window layout.

       -n, --no-sway
              Disable integration with sway WM (window position management).

KEYBINDINGS

       Default key bindings can be overridden with the configuration file.

       Arrows and vim-like moving keys (h,j,k,l)
              Move the view point.

       +, =   Zoom in.

       -      Zoom out.

       0      Set scale to 100%.

       Z      Scale the image to fit the window.

       z      Scale the image to fit the window, but no more than 100%.

       Backspace
              Reset position and scale to defaults.

       F5, [  Rotate 90 degrees anticlockwise.

       F6, ]  Rotate 90 degrees clockwise.

       F7     Flip vertical.

       F8     Flip horizontal.

       i      Show/hide image properties.

       f, F11 Toggle full screen mode.

       PgDown, Space, n
              Open next file.

       PgUp, p
              Open previous file.

       N      Open file from next directory.

       P      Open file from previous directory.

       Home, g
              Open the first file.

       End, G Open the last file.

       F2, O  Show previous frame.

       F3, o  Show next frame.

       F4, s  Start/stop animation.

       F9     Start/stop slideshow mode.

       a      Enable/disable anti-aliasing.

       r      Reload current image.

       e      Execute system command for the current file.

       Esc, Enter, F10, q
              Exit the program.

ENVIRONMENT

       SWAYSOCK
              Path to the socket file used for Sway IPC.

SEE ALSO

       swayimgrc(5)

BUGS

       For   suggestions,   comments,   bug   reports   etc.   visit   the    project    homepage
       ⟨https://github.com/artemsen/swayimg⟩.