table of contents
SWAYIMG(1) | Swayimg manual | SWAYIMG(1) |
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¶
Mandatory arguments to long options are mandatory for short options too.
- -h, --help
- Display help message.
- -v, --version
- Display version information and list of supported image formats.
- -r, --recursive
- Read directories recursively.
- -o, --order=ORDER:
- Set order of the image list:
none: unsorted, order is system depended; alpha: sorted alphabetically (default); random: randomize list.
- -s, --scale=MODE
-
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%). - -l, --slideshow
-
Run slideshow mode on startup.
- -f, --fullscreen
-
Start in full screen mode.
- -p, --position=POS
-
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. - -g, --size=SIZE
-
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. - -a, --class=NAME
-
Set a constant window class/app_id. Setting this may break the window layout.
- -c, --config=SECTION.KEY=VALUE
-
Set a configuration parameter, see swayimgrc(5) for a list of sections and its parameters.
KEYBINDINGS¶
Default key bindings can be overridden with the configuration file.
- F1
- Show/hide help.
- Home
- Open the first file.
- End
- Open the last file.
- PgDown, Space
- Open next file.
- PgUp
- Open previous file.
- d
- Open file from next directory.
- Shift+d
- Open file from previous directory.
- o
- Show next frame.
- Shift+o
- Show previous frame.
- s
- Start/stop animation.
- Shift+s
- Start/stop slideshow.
- f
- Toggle full screen mode.
- Arrows
- Move the view point.
- +, =
- Zoom in.
- -
- Zoom out.
- w
- Zoom the image to fit the window width, this will crop the image.
- Shift+w
- Zoom the image to fit the window height, this will crop the image.
- z
- Zoom the image to fit window.
- Shift+z
- Zoom the image to fill the window, this will crop the image.
- 0
- Set scale to 100%.
- Backspace
- Set optimal scale to fit the window, but not more 100%.
- [
- Rotate the image 90 degrees anticlockwise.
- ]
- Rotate the image 90 degrees clockwise.
- m
- Flip the image vertically.
- Shift+m
- Flip the image horizontally.
- a
- Enable/disable anti-aliasing.
- r
- Reset cache and reload the current image.
- i
- Switch the text info mode.
- e
- Execute external command: prints path to the current file.
- Esc, q
- Exit the program.
ENVIRONMENT¶
- SWAYSOCK
- Path to the socket file used for Sway IPC.
SEE ALSO¶
BUGS¶
For suggestions, comments, bug reports etc. visit the project homepage.
2021-12-28 | swayimg |