geeqie.1

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH GEEQIE "1" "April 2025" "Geeqie 2.5+git20250407-604c9658 GTK3" "User Commands"
.SH NAME
Geeqie - GTK based multiformat image viewer
.SH DESCRIPTION
Geeqie is an interactive GTK based image viewer that supports multiple image formats,
zooming, panning, thumbnails and sorting images into collections.

Generated for version:
.SS "Usage:"
.IP
geeqie [OPTION?] [path...]
.PP
Geeqie is an image viewer.
.IP
Version: Geeqie 2.5+git20250407\-604c9658
.SS "Help Options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
Show help options
.TP
\fB\-\-help\-all\fR
Show all help options
.TP
\fB\-\-help\-gapplication\fR
Show GApplication options
.TP
\fB\-\-help\-gtk\fR
Show GTK+ Options
.SS "Application Options:"
.TP
\fB\-\-action=\fR<ACTION>
execute keyboard action (https://www.geeqie.org/help/GuideReferenceRemoteKeyboardActions.html)
.TP
\fB\-\-action\-list\fR
list available keyboard actions (some are redundant)
.TP
\fB\-b\fR, \fB\-\-back\fR
previous image
.TP
\fB\-\-cache\-metadata\fR
clean the metadata cache
.TP
\fB\-\-cache\-render=\fR<folder>
render thumbnails
.TP
\fB\-\-cache\-render\-recurse=\fR<folder>
render thumbnails recursively
.TP
\fB\-\-cache\-render\-shared=\fR<folder>
render thumbnails (see Help)
.TP
\fB\-\-cache\-render\-shared\-recurse=\fR<folder>
render thumbnails recursively (see Help)
.TP
\fB\-\-cache\-shared\fR=\fI\,clean\/\fR|clear
clear or clean shared thumbnail cache
.TP
\fB\-\-cache\-thumbs\fR=\fI\,clear\/\fR|clean
clear or clean thumbnail cache
.TP
\fB\-\-close\-window\fR
close window
.TP
\fB\-\-config\-load=\fR<FILE>
load configuration from FILE
.TP
\fB\-\-debug\fR=\fI\,[level]\/\fR
turn on debug output
.TP
\fB\-d\fR, \fB\-\-delay=\fR<[H:][M:][N][.M]>
set slide show delay to Hrs Mins N.M seconds,
.TP
\fB\-\-dupes=\fR<FOLDER>
find duplicates in folder
.TP
\fB\-\-dupes\-recurse=\fR<FOLDER>
find duplicates in folder recursively
.TP
\fB\-\-file=\fR<FILE>|<URL>
open FILE or URL bring Geeqie window to the top
.TP
\fB\-\-File=\fR<FILE>|<URL>
open FILE or URL do not bring Geeqie window to the top
.TP
\fB\-\-file\-extensions\fR
list known file extensions
.TP
\fB\-\-first\fR
first image
.TP
\fB\-f\fR, \fB\-\-fullscreen\fR
start / toggle in full screen mode
.TP
\fB\-\-geometry=\fR<W>x<H>[+<XOFF>+<YOFF>]
set main window location and geometry
.TP
\fB\-\-get\-collection=\fR<COLLECTION>
get collection content
.TP
\fB\-\-get\-collection\-list\fR
get collection list
.TP
\fB\-\-get\-destination=\fR<FILE>
get destination path of FILE (https://www.geeqie.org/help/GuidePluginsConfig.html)
.TP
\fB\-\-get\-file\-info\fR
get file info
.TP
\fB\-\-get\-filelist\fR=\fI\,[\/\fR<FOLDER>]
get list of files and class
.TP
\fB\-\-get\-filelist\-recurse\fR=\fI\,[\/\fR<FOLDER>]
get list of files and class recursive
.TP
\fB\-\-get\-rectangle\fR
get rectangle coordinates
.TP
\fB\-\-get\-render\-intent\fR
get render intent
.TP
\fB\-\-get\-selection\fR
get list of selected files
.TP
\fB\-\-get\-sidecars=\fR<FILE>
get list of sidecars of FILE
.TP
\fB\-\-get\-window\-list\fR
get list of windows
.TP
\fB\-g\fR, \fB\-\-grep=\fR<regexp>
filter debug output
.TP
\fB\-\-id=\fR<ID>
window id for following commands
.TP
\fB\-\-last\fR
last image
.TP
\fB\-o\fR, \fB\-\-log\-file=\fR<file>
save log data to file
.TP
\fB\-\-lua=\fR<FILE>,<lua script>
run lua script on FILE
.TP
\fB\-\-new\-window\fR
new window
.TP
\fB\-n\fR, \fB\-\-next\fR
next image
.TP
\fB\-\-pixel\-info\fR
print pixel info of mouse pointer on current image
.TP
\fB\-\-print0\fR
terminate returned data with null character instead of newline
.TP
\fB\-q\fR, \fB\-\-quit\fR
quit
.TP
\fB\-\-raise\fR
bring the Geeqie window to the top
.TP
\fB\-\-selection\-add\fR=\fI\,[\/\fR<FILE>]
adds the current file (or the specified file) to the current selection
.TP
\fB\-\-selection\-clear\fR
clears the current selection
.TP
\fB\-\-selection\-remove\fR=\fI\,[\/\fR<FILE>]
removes the current file (or the specified file) from the current selection
.TP
\fB\-w\fR, \fB\-\-show\-log\-window\fR
show log window
.TP
\fB\-\-slideshow\-recurse=\fR<FOLDER>
start recursive slide show in FOLDER
.TP
\fB\-s\fR, \fB\-\-slideshow\fR
toggle slide show
.TP
\fB\-\-tell\fR
print filename [and Collection] of current image
.TP
\fB\-t\fR, \fB\-\-tools\fR
toggle tools
.TP
\fB\-v\fR, \fB\-\-version\fR
print version info
.TP
\fB\-\-view=\fR<FILE>
open FILE in new window
.TP
\fB\-\-display\fR=\fI\,DISPLAY\/\fR
X display to use
.IP
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.
.IP
If more than one folder is on the command line, only the last will be used.
.IP
If more than one file is on the command line:
.IP
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.
.IP
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
.IP
To disable Clutter use:
GQ_DISABLE_CLUTTER=y[es] geeqie
.IP
To run or stop Geeqie in cache maintenance (non\-GUI) mode use:
GQ_CACHE_MAINTENANCE=y[es] geeqie \fB\-\-help\fR
.IP
User manual: https://www.geeqie.org/help/GuideIndex.html
.IP
: https://www.geeqie.org/help\-pdf/help.pdf
.SH BUGS
Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
.SH COPYRIGHT
Copyright (C) 1999-2004 by John Ellis. Copyright (C) 2004-2025 by The Geeqie Team. Use this software  at  your
own  risk! This  software released under the GNU General Public License. Please read the COPYING file for more
information.