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.

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

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

F2, O

Show previous frame.

F3, o

Show next frame.

F4, s

Start/stop animation.

F9

Start/stop slideshow mode.

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.