SWAYIMG(1) Swayimg manual SWAYIMG(1)

swayimg - lightweight image viewer for Wayland display servers

swayimg [OPTIONS]... [FILE]...

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.

Mandatory arguments to long options are mandatory for short options too.

Display help message.
Display version information and list of supported image formats.
Read directories recursively.
Set order of the image list: 
none: unsorted, order is system depended;
alpha: sorted alphabetically (default);
random: randomize list.
Set the default image scale, valid modes are:
optimal: 100% or less to fit to window (default);
width: fit image width to window width;
height: fit image height to window height;
fit: fit to window;
fill: crop image to fill the window;
real: real size (100%).
Run slideshow mode on startup.
Start in full screen mode.
Set initial position of the window (Sway only):
parent: set position from parent (currently active) window (default);
X,Y: absolute coordinates of the top left corner.
Set initial size of the window:
parent: set size from parent (currently active) window (Sway only, default);
image: set size from the first loaded image;
WIDTH,HEIGHT: absolute size of the window in pixels.
Set a constant window class/app_id. Setting this may break the window layout.
Set a configuration parameter, see swayimgrc(5) for a list of sections and its parameters.

Default key bindings can be overridden with the configuration file.

Show/hide help.
Open the first file.
Open the last file.
Open next file.
Open previous file.
Open file from next directory.
Open file from previous directory.
Show next frame.
Show previous frame.
Start/stop animation.
Start/stop slideshow.
Toggle full screen mode.
Move the view point.
+, =
Zoom in.
-
Zoom out.
Zoom the image to fit the window width, this will crop the image.
Zoom the image to fit the window height, this will crop the image.
Zoom the image to fit window.
Zoom the image to fill the window, this will crop the image.
0
Set scale to 100%.
Set optimal scale to fit the window, but not more 100%.
[
Rotate the image 90 degrees anticlockwise.
]
Rotate the image 90 degrees clockwise.
Flip the image vertically.
Flip the image horizontally.
Enable/disable anti-aliasing.
Reset cache and reload the current image.
Switch the text info mode.
Execute external command: prints path to the current file.
Exit the program.

Path to the socket file used for Sway IPC.

swayimgrc(5)

For suggestions, comments, bug reports etc. visit the project homepage.

2021-12-28 swayimg