![]() |
![]()
| ![]() |
![]()
NAMEswayimg - image viewer for Wayland display servers SYNOPSISswayimg [OPTIONS]... [FILE]... DESCRIPTIONIf 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. Use prefix exec:// to get image data from stdout printed by external command. OPTIONS-h, --help Display help message and exit.
-v, --version Display version information and list of supported image
formats.
-g, --gallery Start in gallery mode.
-F, --from-file Interpret FILE as text list of image files.
-r, --recursive Read directories recursively.
-o, --order=ORDER Set order of the image list:
-s, --scale=MODE Set image scale:
-l, --slideshow Run slideshow on startup.
-f, --fullscreen Start in full screen mode.
-p, --position=parent|X,Y Set window position, this option valid only in Sway WM:
-w, --size=fullscreen|parent|image|W,H Set window size:
-a, --class=NAME Set window class/app_id.
-i, --ipc=FILE Start IPC server based on UNIX sockets. FILE must
point to the UNIX socket file to create. The IPC protocol is a simple
text-based one-way protocol that allows clients to submit actions for
execution. For a list of actions and their parameters, see
swayimgrc(5).
-c, --config=SECTION.KEY=VALUE Override configuration parameter, see swayimgrc(5)
for a list of sections and their parameters.
-C, --config-file=FILE Load configuration from specified FILE.
SWAY/HYPRLAND INTEGRATIONSway/Hyprland integration mode is automatically enabled if IPC for these compositors is present in the system. This mode provides some features such as setting the window position and getting the workspace layout. By default, the application creates an "overlay" above the currently active window, which gives the illusion that the image is opened directly inside the terminal window. ENVIRONMENTSWAYSOCK Path to the socket file used for Sway IPC.
HYPRLAND_INSTANCE_SIGNATURE, XDG_RUNTIME_DIR Path to the socket file used for Hyprland IPC.
XDG_CONFIG_HOME, XDG_CONFIG_DIRS, HOME Prefix of the path to the application config file, see
swayimgrc(5) for details.
XDG_CACHE_HOME, HOME Prefix for the path used as persistent storage for
thumbnails.
SHELL Shell for executing an external command and loading an
image from stdout.
SIGNALSSIGUSR1, SIGUSR2 Perform the actions specified in the config file.
EXIT STATUSThe exit status is 0 if the program completed successfully and 1 if an error occurred. EXAMPLESView multiple files: swayimg photo.jpg logo.png Start slideshow for all files (recursively) in the current directory in random order: swayimg --slideshow --recursive --order=random View using pipes: wget -qO- https://www.kernel.org/theme/images/logos/tux.png | swayimg - Loading stdout from external commands: swayimg "exec://wget -qO- https://www.kernel.org/theme/images/logos/tux.png" \ View all images from the current directory in gallery mode: swayimg --gallery SEE ALSOswayimgrc(5) BUGSFor suggestions, comments, bug reports, etc. visit the project homepage https://github.com/artemsen/swayimg.
|