kitten-@-set-background-image(1)                                 kitten Manual

<?><?><?> (NAME)
       kitten-@-set-background-image - <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> kitty

<?><?><?><?> <?><?><?><?><?><?><?> (USAGE)
       kitten @ set-background-image PATH_TO_IMAGE_OR_INDEX

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?> none <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>.
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>:
       PNG<?> JPEG<?> WEBP<?> GIF<?> BMP <?> TIFF.

       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>. <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>/<?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?>:
       set-background -- -1 <?><?> set-background 3

<?><?><?><?><?><?><?><?> (OPTIONS)
       --all, -a [=no]
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --configured, -c [=no]
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?> none <?><?><?><?>
              <?><?><?> *<?><?><?><?><?>* <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?>.

       --layout [=configured]
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?>
              configured <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?>: configured<?> centered<?> clamped<?>
       cscaled<?> mirror-tiled<?> scaled<?> tiled

       --no-response [=no]
              <?><?><?><?><?> <?><?><?><?> <?><?> kitty <?><?><?><?><?>.
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?>.

       --match, -m
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?> field:query <?><?><?><?><?>. <?><?> <?><?><?><?><?>
              field <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?>: id<?> title<?> pid<?> cwd<?> cmdline<?>
              num<?> env<?> var<?> state<?> neighbor<?> session <?> recent.
              <?><?><?> query <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?>.

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

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>: id<?> pid<?> num <?>
       recent<?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> id <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> -1 <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?>.

       <?><?><?><?> num <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?> <?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> kitten @ ls
       <?><?><?><?><?> <?><?><?><?><?><?><?>).

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

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

       <?><?><?><?> neighbor <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?>: left<?> right<?> top <?><?>
       bottom.

       <?><?><?><?> session <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?>
       <?><?><?><?><?> ^$ <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> .  <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
       <?><?> ~ <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       (<?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?>) <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> env
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?>: env:MY_ENV_VAR=2.

       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> var <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?> env<?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?> <?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?>.

       <?><?><?><?> state <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>:
       active<?> focused<?> needs_attention<?> parent_active<?>
       parent_focused<?> focused_os_window<?> self <?> overlay_parent.
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> focused_os_window <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?> self <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?> overlay_parent
       <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> self
       <?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       self <?><?> <?><?><?><?><?> <?><?><?><?>) <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> kitten @ ls
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

       --help, -h [=no]
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (GLOBAL OPTIONS)
       --to   <?><?><?><?><?> <?><?><?><?><?> kitty <?><?><?><?>
              <?><?><?><?><?>. <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> kitty <?><?>
              <?><?><?><?> <?><?><?><?><?> --listen-on <?><?> <?><?><?><?><?>
              listen_on <?><?> <?><?><?><?> kitty.conf <?><?><?>. <?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> KITTY_LISTEN_ON <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?> kitty <?><?><?><?> <?><?><?>.

       --password
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              kitty. <?><?><?> <?><?><?><?> <?><?><?><?><?><?> kitty <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
              kitty.conf <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              --use-password <?><?> <?><?><?><?><?> <?><?> always <?><?><?><?>
              <?><?><?><?>.

       --password-file [=rc-pass]
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> kitty
              <?><?> <?><?><?><?><?><?><?>. <?><?> - <?><?><?><?>
              <?><?><?><?><?><?> <?><?> STDIN <?><?><?><?><?><?><?>
              <?><?><?><?>. <?><?> fd:num <?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (file
              descriptor) <?><?><?><?><?> num <?><?><?><?><?><?><?>
              <?><?><?><?>. <?><?> <?><?><?><?><?> <?><?> --password
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?> rc-pass <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> kitty
              <?><?><?><?><?><?><?>.

       --password-env [=KITTY_RC_PASSWORD]
              <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>. <?><?>
              <?><?><?><?><?> <?><?> --password-file <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> KITTY_RC_PASSWORD
              <?><?><?><?><?> <?><?><?><?><?><?>.

       --use-password [=if-available]
              <?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> kitty <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
              <?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>.
              <?><?><?> <?><?><?> always <?><?><?><?><?> <?><?><?> <?>
              <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?>: if-available<?> always <?> never

0.48.2                           July 30, 2026
                                              kitten-@-set-background-image(1)