SWAYIMG(1)

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