geeqie1
Gtk based multiformat image viewer
Overview
Geeqie is an interactive GTK based image viewer that supports multiple image formats, zooming, panning, thumbnails and sorting images into collections.
Generated for version:
Usage:
-
geeqie [OPTION…] [path…]
Geeqie is an image viewer.
-
Version: Geeqie 3.3
Help Options:
-
-h, --help -
Show help options
-
--help-all -
Show all help options
-
--help-gapplication -
Show GApplication options
Application Options:
-
--action=<ACTION> -
execute keyboard action (https://www.geeqie.org/help/GuideReferenceRemoteKeyboardActions.html)
-
--action-list -
list available keyboard actions (some are redundant)
-
-b, --back -
previous image
-
--cache-metadata -
clean the metadata cache
-
--cache-render=<folder> -
render thumbnails
-
--cache-render-recurse=<folder> -
render thumbnails recursively
-
--cache-thumbs=clear|clean -
clear or clean thumbnail cache
-
--close-window -
close window
-
--config-load=<FILE> -
load configuration from FILE
-
-d, --delay=<[H:][M:][N][.M]> -
set slide show delay to Hrs Mins N.M seconds,
-
--dupes=<FOLDER> -
find duplicates in folder
-
--dupes-export -
export duplicates search result
-
--dupes-recurse=<FOLDER> -
find duplicates in folder recursively
-
--file=<FILE>|<URL> -
open FILE or URL bring Geeqie window to the top
-
--File=<FILE>|<URL> -
open FILE or URL do not bring Geeqie window to the top
-
--file-extensions -
list known file extensions
-
--first -
first image
-
-f, --fullscreen -
start / toggle in fullscreen mode
-
--geometry=<W>x<H>[+<XOFF>+<YOFF>] -
set main window location and geometry
-
--get-collection=<COLLECTION> -
get collection content
-
--get-collection-list -
get collection list
-
--get-destination=<FILE> -
get destination path of FILE (https://www.geeqie.org/help/GuidePluginsConfig.html)
-
--get-file-info -
get file info
-
--get-filelist=[<FOLDER>] -
get list of files and class
-
--get-filelist-recurse=[<FOLDER>] -
get list of files and class recursive
-
--get-rectangle -
get rectangle coordinates
-
--get-render-intent -
get render intent
-
--get-selection -
get list of selected files
-
--get-sidecars=<FILE> -
get list of sidecars of FILE
-
--get-window-list -
get list of windows
-
--id=<ID> -
window id for following commands
-
--last -
last image
-
-o, --log-file=<file> -
save log data to file
--lua=<FILE>,<lua script>-
run lua script on FILE
-
--new-window -
new window
-
-n, --next -
next image
-
--pixel-info -
print pixel info of mouse pointer on current image
-
--print0 -
terminate returned data with null character instead of newline
-
-q, --quit -
quit
-
--raise -
bring the Geeqie window to the top
-
--selection-add=[<FILE>] -
adds the current file (or the specified file) to the current selection
-
--selection-clear -
clears the current selection
-
--selection-remove=[<FILE>] -
removes the current file (or the specified file) from the current selection
-
-w, --show-log-window -
show log window
-
--slideshow-recurse=<FOLDER> -
start recursive slide show in FOLDER
-
-s, --slideshow -
toggle slide show
-
--tell -
print filename [and Collection] of current image
-
-t, --tools -
toggle tools
-
-v, --version -
print version info
-
--view=<FILE> -
open FILE in new window
-
All other command line parameters are used as plain files if they exist, or a URL or a folder. The name of a collection, with or without either path or extension (.gqv) may be used.
-
If more than one folder is on the command line, only the last will be used.
-
If more than one file is on the command line:
-
If they are in the same folder, that folder will be opened and those files will be selected. If they are not in the same folder, a new Collection containing those files will be opened.
-
To run Geeqie as a new instance, use: GQ_NEW_INSTANCE=y[es] geeqie Normally a single set of configuration files is used for all instances. However, the environment variables XDG_CONFIG_HOME, XDG_CACHE_HOME, XDG_DATA_HOME can be used to modify this behavior on an individual basis e.g. XDG_CONFIG_HOME=/tmp/a XDG_CACHE_HOME=/tmp/b GQ_NEW_INSTANCE=y geeqie
-
To run or stop Geeqie in cache maintenance (non-GUI) mode use: GQ_CACHE_MAINTENANCE=y[es] geeqie
--helpNote that bash command line completion does not work in this mode.
-
User manual: https://www.geeqie.org/help/GuideIndex.html
-
: https://www.geeqie.org/help-pdf/help.pdf
Releases
10 releases since Debian 5.0 (Lenny); the text changed 5 times.
--File since Debian 13 (Trixie);
--action since Debian 13 (Trixie);
--action-list since Debian 13 (Trixie);
--back since Debian 10 (Buster);
--cache-metadata since Debian 10 (Buster);
--cache-render since Debian 13 (Trixie);
--cache-render-recurse since Debian 13 (Trixie);
--cache-render-shared since Debian 13 (Trixie);
--cache-render-shared-recurse since Debian 13 (Trixie);
--cache-shared since Debian 13 (Trixie);
--cache-thumbs since Debian 13 (Trixie);
--close-window since Debian 10 (Buster);
--config-load since Arch Linux 2026-11-01;
--delay since Arch Linux 2026-11-01;
--dupes since Arch Linux 2026-11-01;
--dupes-export since Arch Linux 2026-11-01;
--dupes-recurse since Arch Linux 2026-11-01;
--file since Debian 13 (Trixie);
--file-extensions since Arch Linux 2026-11-01;
--first since Debian 10 (Buster);
--geometry since Debian 10 (Buster);
--get-collection since Debian 13 (Trixie);
--get-collection-list since Debian 10 (Buster);
--get-destination since Debian 13 (Trixie);
--get-file-info since Debian 11 (Bullseye);
--get-filelist since Debian 13 (Trixie);
--get-filelist-recurse since Debian 13 (Trixie);
--get-rectangle since Debian 10 (Buster);
--get-render-intent since Debian 10 (Buster);
--get-selection since Debian 13 (Trixie);
--get-sidecars since Debian 13 (Trixie);
--get-window-list since Debian 13 (Trixie);
--help-all since Arch Linux 2026-11-01;
--help-gapplication since Arch Linux 2026-11-01;
--id since Debian 13 (Trixie);
--last since Debian 10 (Buster);
--log-file since Debian 13 (Trixie);
--new-window since Debian 10 (Buster);
--next since Debian 10 (Buster);
--pixel-info since Debian 10 (Buster);
--print0 since Debian 11 (Bullseye);
--quit since Debian 10 (Buster);
--raise since Debian 10 (Buster);
--selection-add since Debian 13 (Trixie);
--selection-clear since Debian 13 (Trixie);
--selection-remove since Debian 13 (Trixie);
--show-log-window since Debian 13 (Trixie);
--slideshow-recurse since Debian 13 (Trixie);
--tell since Debian 10 (Buster);
--tools since Arch Linux 2026-11-01;
--view since Debian 13 (Trixie);
-b since Debian 10 (Buster);
-d since Arch Linux 2026-11-01;
-n since Debian 10 (Buster);
-o since Debian 13 (Trixie);
-q since Debian 10 (Buster);
-w since Debian 13 (Trixie).
--PWD until Debian 13 (Trixie);
--blank until Debian 13 (Trixie);
--cache-maintenance until Debian 13 (Trixie);
--debug until Debian 13 (Trixie);
--disable-clutter until Debian 13 (Trixie);
--fullscreen-start until Debian 13 (Trixie);
--fullscreen-stop until Debian 13 (Trixie);
--grep until Debian 13 (Trixie);
--list until Debian 9 (Stretch);
--list-add until Debian 13 (Trixie);
--list-clear until Debian 13 (Trixie);
--new-instance until Debian 13 (Trixie);
--remote until Debian 13 (Trixie);
--remote-help until Debian 12 (Bookworm);
--slideshow-start until Debian 13 (Trixie);
--slideshow-stop until Debian 13 (Trixie);
--tools-hide until Debian 13 (Trixie);
--tools-show until Debian 13 (Trixie);
--with-tools until Debian 13 (Trixie);
--without-tools until Debian 13 (Trixie);
-T until Debian 13 (Trixie);
-cm until Debian 12 (Bookworm);
-fS until Debian 12 (Bookworm);
-fs until Debian 12 (Bookworm);
-g until Debian 13 (Trixie);
-l until Debian 9 (Stretch);
-r until Debian 13 (Trixie);
-rh until Debian 12 (Bookworm);
-sS until Debian 12 (Bookworm);
-ss until Debian 12 (Bookworm).