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.