SWAYIMG(1)               <?><?><?><?><?><?><?> swayimg              SWAYIMG(1)

<?><?><?> (NAME)
       swayimg - <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> Wayland/DRM <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> Lua

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       swayimg [OPTION]... [FILE]...

       <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> stdin<?> <?><?> - <?><?> <?><?><?><?><?> FILE
       <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> stdout <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> exec://
       <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> swayimg <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?> <?><?><?><?> Wayland <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> Sway <?> Hyprland
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> (overlay) <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> stdin <?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> Lua <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -h, --help
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>.

       -V, --version
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?>.

       -v, --viewer
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>.

       -g, --gallery
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?>.

       -s, --slideshow
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?>.

       -f, --from-file=FILE
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?> FILE <?><?><?><?>.

       -P, --position=X,Y
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           (<?><?><?><?> <?><?> Sway/Hyprland).

       -S, --size=W,H
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       -F, --fullscreen
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>.

       -c, --config=FILE
           <?><?><?><?><?><?><?><?> FILE <?><?><?><?><?><?><?><?> Lua
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       -e, --execute=LUA
           <?><?><?><?><?> <?><?><?><?><?><?><?> Lua <?><?><?><?><?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       --appid=ID
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (application
           Id).

       --verbose
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?>.

<?><?><?><?><?><?> (KEYS)
   <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> (Viewer and Slideshow)
       o   Esc: <?><?><?><?> <?><?> <?><?><?><?><?><?>
       o   Enter: <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       o   s: <?><?><?><?>/<?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?>
       o   Insert: <?><?><?><?><?><?><?><?><?><?><?>/<?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       o   Delete: <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           (<?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>)
       o   f: <?><?><?><?>/<?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?>
       o   a: <?><?><?><?>/<?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (anti-aliasing)
       o   ]: <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       o   [: <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       o   m: <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       o   Shift-m: <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       o   t: <?><?><?><?><?>/<?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?>
       o   PgDown: <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       o   PgUp: <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       o   Shift-PgDown: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       o   Shift-PgUp: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       o   +: <?><?><?><?><?><?><?><?><?><?>
       o   -: <?><?><?><?><?><?><?><?><?><?>
       o   Left/Right/Up/Down: <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       o   Backspace: <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?>

       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:
       o   ScrollUp/ScrollDown/ScrollLeft/ScrollRight:
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       o   Ctrl-ScrollUp: <?><?><?><?><?><?><?><?><?><?>
       o   Ctrl-ScrollDown: <?><?><?><?><?><?><?><?><?><?>
       o   MouseLeft: <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           (<?><?><?><?><?>)
       o   MouseRight: <?><?><?><?><?> <?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?>

   <?><?><?><?><?> (Gallery)
       o   Esc: <?><?><?><?> <?><?> <?><?><?><?><?><?>
       o   Home: <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>
       o   End: <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>
       o   Left: <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?>
       o   Right: <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>
       o   Up: <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       o   Down: <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>
       o   PgUp: <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       o   PgDown: <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       o   Enter: <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       o   s: <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       o   Insert: <?><?><?><?><?><?><?><?><?><?><?>/<?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?>
       o   Delete: <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           (<?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>)
       o   f: <?><?><?><?>/<?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?>
       o   a: <?><?><?><?>/<?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (anti-aliasing)
       o   +: <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?>
       o   -: <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?>
       o   t: <?><?><?><?><?>/<?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?>

       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:
       o   MouseLeft: <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?>
       o   MouseRight: <?><?><?><?><?> <?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?>
       o   Ctrl-ScrollUp: <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       o   Ctrl-ScrollDown: <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?>
       o   ScrollUp/ScrollDown/ScrollLeft/ScrollRight: <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>

<?><?><?><?> (ENVIRONMENT)
       SWAYSOCK
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> Sway IPC.

       HYPRLAND_INSTANCE_SIGNATURE, XDG_RUNTIME_DIR
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> Hyprland IPC.

       XDG_CONFIG_HOME, XDG_CONFIG_DIRS, HOME
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       SHELL
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> stdout.

<?><?><?><?><?><?><?><?><?> (SIGNALS)
       SIGUSR1, SIGUSR2
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> 0 <?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?> 1 <?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> Lua <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>:
           swayimg photo.jpg logo.png

       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> pipe:
           wget -qO- https://www.kernel.org/theme/images/logos/tux.png |
           swayimg -

       <?><?><?><?><?><?><?><?> stdout <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?>:
           swayimg "exec://wget -qO-
           https://www.kernel.org/theme/images/logos/tux.png" \
                   "exec://curl -so-
           https://www.kernel.org/theme/images/logos/tux.png"

<?><?><?><?><?><?><?> (FILES)
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> init.lua <?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> Lua <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> (hooks) <?><?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>:
       o   $XDG_CONFIG_HOME/swayimg/init.lua
       o   $HOME/.config/swayimg/init.lua
       o   $XDG_CONFIG_DIRS/swayimg/init.lua
       o   /etc/xdg/swayimg/init.lua

<?><?><?><?><?> <?><?><?><?><?><?> (BUGS)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> https://github.com/artemsen/swayimg <?><?><?><?><?><?>
       <?><?><?><?>.

swayimg                           2026-03-08                        SWAYIMG(1)