NAME

       swayimg - image viewer for Sway/Wayland

SYNOPSIS

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

DESCRIPTION

       The  swayimg  utility  can  be used for preview images inside the currently focused window
       (container).

       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.

       The program uses Sway IPC to determine the geometry of the currently focused workspace and
       window.  This data is used calculate the position and size of  a  new  window.   Then  the
       program  adds  two  rules  to  the Sway: "floating enable" and "move position" for swayimg
       application, 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: sort alphabetically (default);
              random: randomize list.

       -r, --recursive
              Read directories recursively.

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

       -m, --mark
              Enable marking mode. Any file in the image list can be marked (see keybindings),
              and when the program exits, the list of marked files will be printed to stdout.

       -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 Sway
              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.
              ´default´: 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).

       -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

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

       +, =   Zoom in.

       -      Zoom out.

       0      Set scale to 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.

       Insert, m
              Invert mark sate for current file.

       *, M   Invert mark sate for all files.

       a      Mark all files.

       A      Unmark all files.

       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⟩.