swayimg - lightweight image viewer for Wayland display servers

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  KEYBINDINGS  ENVIRONMENT  SEE ALSO  BUGS 

---

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.

---