pqiv(1) General Commands Manual pqiv(1) (NAME) pqiv - (SYNOPSIS) pqiv [options] [filename(s)...] (DESCRIPTION) pqiv qiv . . (OPTIONS) -c, --transparent-background pqiv . . -d, --slideshow-interval=SECONDS ( --slideshow s ) . 0.5 . -f, --fullscreen . f . -F, --fade (Fade) . --fade-duration . -i, --hide-info-box . i . --font=FONT Pango . . -l, --lazy-load pqiv . . -n, --sort . ( ). --sort-key . -P, --window-position=POSITION . POSITION : x,y off . -r, --additional-from-stdin / . --actions-from-stdin . -s, --slideshow . s . -t, --scale-images-up . t . --disable-scaling . -T, --window-title=TITLE . pqiv TITLE : $BASEFILENAME ( `image.png') $FILENAME ( `/home/user/image.png') $WIDTH $HEIGHT $ZOOM $IMAGE_NUMBER $IMAGE_COUNT . `pqiv: $FILENAME ($WIDTHx$HEIGHT) $ZOOM% [$IMAGE_NUMBER/$IMAGE_COUNT]' . -z, --zoom-level=FLOAT 1.0 100% . ( --scale-images-up --disable-scaling) . -1, --command-1=COMMAND COMMAND 1. 2..9 . ACTIONS ( ) . COMMAND . `$1' . `|' `-' `$1' . COMMAND `>' (popup) . COMMAND `|' (pipe) . . COMMAND `-' . --action=ACTION (ACTION) pqiv. : command(parameter); command(parameter); ACTIONS . --actions-from-stdin --action . ACTIONS . --additional-from-stdin . --allow-empty-window pqiv . pqiv . --auto-montage-mode (montage) pqiv . --background-pattern=PATTERN pqiv . . : checkerboard white black. --bind-key=KEY BINDING (action). : key sequence { command(parameter); command(parameter); } (key sequence) `' name GDK (`Mouse-1') (`Mouse-Scroll-1') . `ab' `a' control + `b' . `a' `ab' `a' `b' . . ACTIONS . xev . keysym `keysym' . xmodmap -pk https://git.gnome.org/browse/gtk+/plain/gdk/gdkkeysyms.h ..PP pqiv . montage : montage . @MONTAGE { ... } . --box-colors=FOREGROUND COLOR:BACKGROUND COLOR montage. RGB 0 255 (hexvalue) #aabbcc . #000000:#ffff00 . --browse . pqiv . --disable-backends=LIST OF BACKENDS pqiv . . . archive . : archive archive_cbx *.cb? libav ffmpeg gdkpixbuf poppler PDF spectre PS/EPS wand ImageMagick PSD webp WebP --disable-scaling . t . --scale-images-up . --end-of-files-action=ACTION pqiv . . ACTION : quit pqiv wait . --watch-directories wrap () . (shuffle) wrap-no-reshuffle wrap . --enforce-window-aspect-ratio . pqiv . . . --fade-duration=SECONDS --fade . 0.5 . --low-memory . pqiv . . --max-depth=LEVELS pqiv . pqiv . 0 pqiv . --negate () . n . --shuffle . --sort . . --end-of-files-action . Control + R . --show-bindings . --bind-key . ACTIONS . --sort-key=PROPERTY . PROPERTY : name abc32d abc112d b1 mtime . --thumbnail-size=WIDTHxHEIGHT montage. 128x128 . --thumbnail-preload=COUNT COUNT montage. montage . --thumbnail-persistence=DIRECTORY/STATUS . yes . Thumbnail Managing Standard $XDG_CACHE_HOME/thumbnails/* . 128x128 256x256 512x512 1024x1024 . x-pqiv . standard . - montage . read-only . read-only . local pqiv Thumbnail Managing Standard .sh_thumbnails . pqiv . . .sh_thumbnails --watch-directories . pqiv . --recreate-window : . . --scale-mode-screen-fraction=FRACTION pqiv . 0.8 (80%) . --wait-for-images-to-appear . --lazy-load --watch-directories . --watch-directories pqiv . --sort . --watch-files . --watch-files=VALUE . VALUE : on () changes-only off . (unload) pqiv . ( --low-memory .) (ACTIONS) pqiv . : COMMAND(PARAMETER) COMMAND PARAMETER . . (backslash) (escape ). `command(echo \))' `)' . : add_file(STRING) . animation_step(INT) . animation_continue() . animation_set_speed_relative(DOUBLE) . animation_set_speed_absolute(DOUBLE) . 1.0 . bind_key(STRING) (key binding). . send_keys(STRING) . clear_marks() . command(STRING) . --command-1 . flip_horizontally() . flip_vertically() . goto_directory_relative(INT) n- . goto_earlier_file() . goto_file_byindex(INT) . goto_file_byname(STRING) . goto_file_relative(INT) n- . goto_logical_directory_relative(INT) n- . PDF . . (/) (#) . hardlink_current_image() (hardlink) ./.pqiv-select/ . jump_dialog() . montage_mode_enter() . montage_mode_follow(KEYS) (follow): KEYS . (binding overlays) . montage_mode_return_proceed() . montage_mode_return_cancel() . montage_mode_set_shift_x(INT) 0. montage_mode_set_shift_y(INT) 0. montage_mode_set_wrap_mode(INT) : 1 . 0 . 2 . montage_mode_shift_x(INT) . . montage_mode_shift_y(INT) . montage_mode_show_binding_overlays(INT) ( 0) ( ) (follow mode). pqiv (mnemonics) ( ) . vimperator/pentadactyl/vimium . montage_mode_shift_y_pg(INT) n . move_window(INT, INT) pqiv . () . nop() . . numeric_command(INT) n- --command-1 . output_file_list() . quit() pqiv. reload() . remove_file_byindex(INT) . remove_file_byname(STRING) . reset_scale_level() . rotate_left() ..TP rotate_right() . send_keys(STRING) . ASCII . bind_key(STRING) . set_cursor_visibility(INT) 0 . set_cursor_auto_hide(INT) . 0 . pqiv . set_fade_duration(DOUBLE) (fade) . . . set_interpolation_quality(INT) . : 0 1 ( nearest "good" Cairo ) 2 "fast" 3 "good" 4 "best". set_keyboard_timeout(DOUBLE) (timeout) . a ab pqiv b a . . set_scale_level_absolute(DOUBLE) . 1.0 . : --zoom-level. set_scale_level_relative(DOUBLE) . set_scale_mode_fit_px(INT, INT) . set_scale_mode_screen_fraction(DOUBLE) . 0.8 . montage . set_shift_align_corner(STRING) / . NE ( ) . C . set_shift_x(INT) . set_shift_y(INT) . set_slideshow_interval_absolute(DOUBLE) . set_slideshow_interval_relative(DOUBLE) . : --slideshow-interval. set_status_output(INT) pqiv (stdout) . . CURRENT_FILE_NAME CURRENT_FILE_INDEX . . set_thumbnail_preload(INT) . . set_thumbnail_size(INT,INT) . . . shift_x(INT) x . shift_y(INT) y . toggle_background_pattern(INT) : 0 1 2 3 . toggle_fullscreen(INT) : 0 1 2 . toggle_info_box() (info box). toggle_mark() . toggle_negate_mode(INT) ( ): 0 1 2 . toggle_scale_mode(INT) : 1 2 () 3 4 5 . 0 1-3 . toggle_shuffle_mode(INT) (shuffle). 0 1 shuffle . toggle_slideshow() . Backspace/Space /. ctrl-a ./.pqiv-select/ (hardlink) . f . h/v . k/l . i . j . m montage . Return . g (thumbnail) . o . ctrl-R . - . q pqiv. r . s . t . ctrl-t . mod-t . Plus/Minus . Period, ctrl-Period . mod-Plus, mod-Minus . ctrl-r (shuffle). ctrl-p . ctrl-Space, ctrl-Backspace /. ctrl-Plus, ctrl-Minus . b (transparent). n ("negative"). Mouse buttons (fullscreen) . Mouse drag (fullscreen) . Mouse drag with right button (fullscreen) . Arrow keys . . . `pqiv --show-bindings' . (CONFIGURATION FILE) pqiv ~/.config/pqivrc . / INI options . (long form) . (boolean) 1 . . `fullscreen=1' pqiv -f . [options] fullscreen=1 sort=1 command-1=|convert - -blur 20 - pqiv (blur) 1 . -f pqiv -n . --bind-key [keybindings] . [keybindings] q { goto_file_relative(-1); } w { goto_file_relative(1); } x { send_keys(#1); } 1 { set_scale_level_absolute(1.); bind_key(x { send_keys(#2\); }); } 2 { set_scale_level_absolute(.5); bind_key(x { send_keys(#3\); }); } 3 { set_scale_level_absolute(0.25); bind_key(x { send_keys(#1\); }); } q w x . () [actions] pqiv . pqiv . ';' '#' . . ~/.pqivrc /etc/xdg/pqivrc /etc/pqivrc. pqiv . PQIVRC_PATH ..SH " (EXAMPLES)" pqiv --bind-key="a { goto_file_byindex(0) }" --bind-key='c { command(echo -n $1 | xclip) }' --sort foo bar.pdf a c xclip foo bar.pdf . pqiv --slideshow --watch-directories --end-of-files-action=wait --slideshow-interval=0.001 test test . . pqiv --slideshow --allow-empty-window --watch-directories --wait-for-images-to-appear --lazy-load test test pqiv . echo "output_file_list(); quit()" | pqiv --actions-from-stdin test test pqiv . (BUGS) https://github.com/phillipberndt/pqiv . (AUTHORS) Phillip Berndt (phillip dot berndt at googlemail dot com) 2.13.3 November 2025 pqiv(1)