SWAYIMG

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.