summaryrefslogtreecommitdiff
path: root/src/help.raw
diff options
context:
space:
mode:
Diffstat (limited to 'src/help.raw')
-rw-r--r--src/help.raw175
1 files changed, 96 insertions, 79 deletions
diff --git a/src/help.raw b/src/help.raw
index e0ea432..0e99c68 100644
--- a/src/help.raw
+++ b/src/help.raw
@@ -2,7 +2,7 @@
Usage : " PACKAGE " [options] <files or directories ...>
- This is just a short option summary. Please consult the manual for details.
+ This is just a short option summary. Please see \"man " PACKAGE "\" for details.
OPTIONS
-h, --help Show help and exit
@@ -10,34 +10,42 @@ OPTIONS
-V, --verbose Show progress bars and other extra information
-q, --quiet Hide non-fatal errors. May be used with --verbose
-T, --theme THEME Load options with name THEME
- -_, --rcfile FILE Use FILE to parse themes and options from
-r, --recursive Recursively expand any directories in FILE to
- the content of those directories. (Take it easy)
+ the content of those directories
+ --no-recursive Do not recursively expand directories
+ (this is the default)
-z, --randomize Randomize the filelist
--no-jump-on-resort Don't jump to the first image when the filelist
is resorted
- -g, --geometry STRING Limit the window size to STRING, like \"640x480\"
+ -g, --geometry WxH[+X+Y] Limit the window size to DIMENSION[+OFFSET]
-f, --filelist FILE Load/save images from/to the FILE filelist
- -|, --start-at POSITION Start at POSITION in the filelist
- -p, --preload Remove unlaodable files from the internal filelist
+ -|, --start-at FILENAME Start at FILENAME in the filelist
+ -p, --preload Remove unloadable files from the internal filelist
before attempting to display anything
- -., --scale-down Automatically scale down images to fit the screen
- size
+ -., --scale-down Automatically scale down images to fit screen size
-F, --fullscreen Make the window full screen
- -Z, --auto-zoom Zoom picture to screen size in full screen mode
+ -Z, --auto-zoom Zoom picture to screen size in fullscreen/geom mode
--zoom PERCENT Zooms images by a PERCENT, when in full screen
mode or when window geometry is fixed. If combined
with --auto-zoom, zooming will be limited to the
- the size.
+ the size. Also support \"max\" and \"fill\"
+ --zoom-step PERCENT Zoom images in and out by PERCENT (default: 25)
+ when using the zoom keys / buttons
+ --keep-zoom-vp Keep viewport zoom and settings while changing images
-w, --multiwindow Open all files at once, one window per image
-x, --borderless Create borderless windows
-d, --draw-filename Show the filename in the image window
+ --draw-tinted Show overlay texts on semi-transparent background
+ --draw-exif Show some Exif information (if compiled with exif=1)
+ --edit Make flip/rotation keys flip/rotate the underlying file
+ --auto-rotate Rotate images according to Exif info (if compiled with exif=1)
-^, --title TITLE Set window title (see FORMAT SPECIFIERS)
-D, --slideshow-delay NUM Set delay between automatically changing slides
- --cycle-once Exit after one loop through the slideshow
+ --on-last-slide quit Exit after one loop through the slide show (old --cycle-once)
+ --on-last-slide hold Stop at both ends of the filelist
-R, --reload NUM Reload images after NUM seconds
- -Q, --builtin Use builtin http client instead of wget
-k, --keep-http Keep local copies when viewing HTTP/FTP files
+ --insecure Disable peer/host verification when using HTTPS.
-K, --caption-path PATH Path to caption directory, enables caption display
-j, --output-dir With -k: Output directory for saved files
-l, --list list mode: ls-style output with image information
@@ -45,15 +53,18 @@ OPTIONS
-U, --loadable List all loadable files. No image display
-u, --unloadable List all unloadable files. No image display
-S, --sort SORT_TYPE Sort files by:
- name, filename, width, height, pixels, size or format
+ name, filename, mtime, width, height, pixels, size,
+ or format
-n, --reverse Reverse sort order
- -A, --action ACTION Specify action to perform when pressing <return>.
+ --version-sort Natural sort of (version) numbers within text
+ -A, --action [;]ACTION Specify action to perform when pressing <return>.
Executed by /bin/sh, may contain FORMAT SPECIFIERS
+ reloads image with \";\", switches to next otherwise
--action[1-9] Extra actions triggered by pressing keys <1>to <9>
- --action-hold-slide Do not change to next image after running an action
-G, --draw-actions Show the defined actions in the image window
+ --tap-zones Enable tap zones for previous/next file in slide show mode
+ --force-aliasing Disable antialiasing
-m, --montage Enable montage mode
- -c, --collage Montage mode with randomly distributed thumbnails
-i, --index Create an index print of all images
--info CMD Run CMD and show its output in the image window
-t, --thumbnails Show images as clickable thumbnails
@@ -62,9 +73,7 @@ OPTIONS
-J, --thumb-redraw N Redraw thumbnail window every N images
-~, --thumb-title STRING Title for windows opened from thumbnail mode
-I, --fullindex Index mode with additional image information
- --index-name BOOL Show/Don't show filename in index/thumbnail mode
- --index-size BOOL Show/Don't show filesize in index/thumbnail mode
- --index-dim BOOL Show/Don't show dimensions in index/thumbnail mode
+ --index-info FORMAT Show FORMAT below images in index/thumbnail mode
--bg-center FILE Set FILE as centered desktop background
--bg-fill FILE Like --bg-scale, but preserves aspect ratio by
zooming the image until it fits. May cut off
@@ -76,41 +85,25 @@ OPTIONS
fill the whole background, but the images' aspect
ratio may not be preserved
--bg-tile FILE Set FILE as tiled desktop background
+ --no-fehbg Do not write a ~/.fehbg file
-C, --fontpath PATH Specify an extra directory to look in for fonts,
can be used multiple times to add multiple paths.
-M, --menu-font FONT Use FONT for the font in menus.
- --menu-style FILE Use FILE as the style descriptor for menu text.
- -), --menu-bg BG Use BG for the background image in menus.
-B, --image-bg STYLE Set background for transparent images and the like.
- Accepted values: white, black, default
+ Accepted values: default, checks, or a XColor (eg. #428bdd)
+ --xinerama-index I Assumee that I is the active xinerama screen
-N, --no-menus Don't load or show any menus.
- -0, --reload-button B Use button B to reload the image (defaults to 0)
- -1, --pan-button B Use button B pan the image (hold button down, move
- the mouse to move the image around. Advances to the
- next image when the mouse is not moved (defaults to
- 1, usually the left button).
- -2, --zoom-button B Use button B to zoom the current image in any
- mode (defaults to 2, usually the middle button).
- -3, --menu-button B Click button B to activate the menu in any
- mode. Set to 0 for any button. This option
- is disabled if the -N or --no-menus option is set
- (defaults to 3, usually the right button).
- --menu-ctrl-mask Require CTRL+Button for menu activation
- -4, --prev-button B Use button B to switch to the previous image
- (defaults to 4, which usually is <mousewheel up>).
- -5, --next-button B Use button B to switch to the next image
- (defaults to 5, which usually is <mousewheel down>).
- -8, --rotate-button B Use CTRL+Button B to rotate the current image in
- any mode (default=2).
- --no-rotate-ctrl-mask Don't require CTRL+Button for rotation in
- any mode -- just use the button (default=off).
- -9, --blur-button B Use CTRL+Button B to blur the current image in
- any mode (default=1).
- --no-blur-ctrl-mask Don't require CTRL+Button for blurring in
- any mode -- just use the button (default=off).
--no-xinerama Disable Xinerama support
--no-screen-clip Do not limit window size to screen size
-Y, --hide-pointer Hide the pointer
+ --conversion-timeout INT Load unknown files with dcraw or ImageMagick,
+ timeout after INT seconds (0: no timeout)
+ --min-dimension WxH Only show images with width >= W and height >= H
+ --max-dimension WxH Only show images with width <= W and height <= H
+ --scroll-step COUNT scroll COUNT pixels when movement key is pressed
+ --cache-size NUM imlib cache size in mebibytes (0 .. 2048)
+ --auto-reload automatically reload shown image if file was changed
+ --window-id ID Draw to an existing X11 window by its ID
MONTAGE MODE OPTIONS
-X, --ignore-aspect Set thumbnail to specified width/height without
@@ -135,60 +128,84 @@ INDEX MODE OPTIONS
font is specified, a title will not be printed
FORMAT SPECIFIERS
+ %a information about slideshow state (playing/paused)
%f image path/filename
+ %F image path/filename (shell-escaped)
+ %g window dimensions (\"width,height\") in pixels
+ %h image height
+ %l total number of files in the filelist
+ %L path to temporary copy of filelist
+ %m current mode (slideshow, multiwindow...)
%n image name
- %s image size (bytes)
+ %N image name (shell-escaped)
+ %o offset of top-left image corner to window (\"x,y\") in pixels
%p image pixel size
- %w image width
- %h image height
+ %P image pixel size in kilo-/megapixels
+ %r image rotation. half right turn == 3.1415 (pi)
+ %s image size in bytes
+ %S image size with appropriate unit (kB/MB)
%t image format
- %P " PACKAGE "
- %v " PACKAGE " version
- %m current mode (slideshow, multiwindow...)
- %l total number of files in the filelist
%u current file number
+ %w image width
+ %v " PACKAGE " version
+ %V process ID
+ %z current image zoom, rounded to two decimal places
+ %Z current image zoom, high precision
%% %
- \\n newline
+ \\n newline
-KEYS
- p, <BACKSPACE>, <LEFT> Go to previous slide
- n, <SPACE>, <RIGHT> Go to next slide
- r Reload image
- v Toggle fullscreen
- m Show menu
- c Enable caption entry mode
- w Resize window to current image dimensions
- h Pause/Continue the slideshow
- z Jump to a random position in the current filelist
+DEFAULT KEYS
a Toggle action display (--draw-actions)
+ A Toggle anti-aliasing
+ c Enable caption entry mode
d Toggle filename display (--draw-filename)
+ e Toggle exif tag display (if compiled with exif=1)
+ f Toggle fullscreen
+ g Toggle fixed geometry mode
+ h pause/continue slideshow
+ i Toggle --info display
+ k Toggle zoom/viewport freeze when switching images
+ L Save current filelist to unique filename
+ m Show/hide menu
+ n, <SPACE>, <RIGHT> Go to next image
+ o Toggle pointer visibility
+ p, <BACKSPACE>, <LEFT> Go to previous image
+ q, <ESCAPE> Quit
+ r Reload image
+ R Render/anti-alias image
s Save current image to unique filename
- f Save current filelist to unique filename
- <, > In place editing, rotate 90 degrees right/left
+ w Resize window to current image dimensions
+ x Close current window
+ z Jump to a random position in the current filelist
+ Z Toggle auto-zoom
+ [, ] Jump to previous/next directory
+ <, > Rotate 90 degrees right/left
+ _ Vertical flip
+ | Horizontal flip
+ 0, <ENTER> Run action specified by --action option
+ 1-9 Run action 1-9 specified by --action[1-9] options
<HOME> Go to first slide
<END> Go to last slide
- <ESCAPE> Quit the slideshow
- + Increase reload delay
- - Decrease reload delay
+ <PAGEUP> Go forward 5% of the filelist
+ <PAGEDOWN> Go backward 5% of the filelist
+ + Increase reload delay by 1 second
+ - Decrease reload delay by 1 second
<DELETE> Remove the currently viewed file from the filelist
<CTRL+DELETE> Like <DELETE>, but also removes the file from the
- filesystem. Caution: Does _not_ ask for confirmation
- x Close current window
- q Quit " PACKAGE "
+ filesystem. Caution: Does not ask for confirmation
<KEYPAD LEFT> Move the image to the left
<KEYPAD RIGHT> Move the image to the right
<KEYPAD UP> Move the image up
<KEYPAD DOWN> Move the image down
<KEYPAD BEGIN> Antialias the image
- <KEYPAD +> Zoom in
- <KEYPAD -> Zoom out
+ <KEYPAD +>, <UP> Zoom in
+ <KEYPAD ->, <DOWN> Zoom out
<KEYPAD *> Zoom to 100%
<KEYPAD /> Zoom to fit the window
- <ENTER>, 0 Run action specified by --action option
- 1-9 Run action 1-9 specified by --action[1-9] options
This program is free software, see the file COPYING for licensing info.
-Copyright Tom Gilbert (and various contributors) 1999-2003
+Copyright Tom Gilbert (and various contributors) 1999-2003.
+Copyright Birte Kristina Friesel (and various contributors) 2010-2020.
-Homepage: https://derf.homelinux.org/p/feh
-Email bugs to <derf@finalrewind.org>
+Homepage: http://feh.finalrewind.org
+Report bugs to <derf+feh@finalrewind.org> or #feh on irc.oftc.net.