1" PACKAGE " version " VERSION "
2
3Usage : " PACKAGE " [options] <files or directories ...>
4
5 This is just a short option summary.  Please see \"man " PACKAGE "\" for details.
6
7OPTIONS
8 -h, --help                Show help and exit
9 -v, --version             Show version information and exit
10 -V, --verbose             Show progress bars and other extra information
11 -q, --quiet               Hide non-fatal errors. May be used with --verbose
12 -T, --theme THEME         Load options with name THEME
13 -r, --recursive           Recursively expand any directories in FILE to
14                           the content of those directories
15     --no-recursive        Do not recursively expand directories
16                           (this is the default)
17 -z, --randomize           Randomize the filelist
18 --no-jump-on-resort       Don't jump to the first image when the filelist
19                           is resorted
20 -g, --geometry WxH[+X+Y]  Limit the window size to DIMENSION[+OFFSET]
21 -f, --filelist FILE       Load/save images from/to the FILE filelist
22 -|, --start-at FILENAME   Start at FILENAME in the filelist
23 -p, --preload             Remove unloadable files from the internal filelist
24                           before attempting to display anything
25 -., --scale-down          Automatically scale down images to fit screen size
26 -F, --fullscreen          Make the window full screen
27 -Z, --auto-zoom           Zoom picture to screen size in fullscreen/geom mode
28     --zoom PERCENT        Zooms images by a PERCENT, when in full screen
29                           mode or when window geometry is fixed. If combined
30                           with --auto-zoom, zooming will be limited to the
31                           the size. Also support \"max\" and \"fill\"
32     --keep-zoom-vp        Keep viewport zoom and settings while changing images
33 -w, --multiwindow         Open all files at once, one window per image
34 -x, --borderless          Create borderless windows
35 -d, --draw-filename       Show the filename in the image window
36     --draw-tinted         Show overlay texts on semi-transparent background
37     --draw-exif           Show some Exif information (if compiled with exif=1)
38     --edit                Make flip/rotation keys flip/rotate the underlying file
39     --auto-rotate         Rotate images according to Exif info (if compiled with exif=1)
40 -^, --title TITLE         Set window title (see FORMAT SPECIFIERS)
41 -D, --slideshow-delay NUM Set delay between automatically changing slides
42     --on-last-slide quit  Exit after one loop through the slide show
43     --on-last-slide hold  Stop at both ends of the filelist
44 -R, --reload NUM          Reload images after NUM seconds
45 -k, --keep-http           Keep local copies when viewing HTTP/FTP files
46     --insecure            Disable peer/host verification when using HTTPS.
47 -K, --caption-path PATH   Path to caption directory, enables caption display
48 -j, --output-dir          With -k: Output directory for saved files
49 -l, --list                list mode: ls-style output with image information
50 -L, --customlist FORMAT   list mode with custom output, see FORMAT SPECIFIERS
51 -U, --loadable            List all loadable files. No image display
52 -u, --unloadable          List all unloadable files. No image display
53 -S, --sort SORT_TYPE      Sort files by:
54                           name, filename, mtime, width, height, pixels, size,
55                           or format
56 -n, --reverse             Reverse sort order
57     --version-sort        Natural sort of (version) numbers within text
58 -A, --action [;]ACTION    Specify action to perform when pressing <return>.
59                           Executed by /bin/sh, may contain FORMAT SPECIFIERS
60                           reloads image with \";\", switches to next otherwise
61     --action[1-9]         Extra actions triggered by pressing keys <1>to <9>
62 -G, --draw-actions        Show the defined actions in the image window
63     --force-aliasing      Disable antialiasing
64 -m, --montage             Enable montage mode
65 -i, --index               Create an index print of all images
66     --info CMD            Run CMD and show its output in the image window
67 -t, --thumbnails          Show images as clickable thumbnails
68 -P, --cache-thumbnails    Enable thumbnail caching for thumbnail mode.
69                           Only works with thumbnails <= 256x256 pixels
70 -J, --thumb-redraw N      Redraw thumbnail window every N images
71 -~, --thumb-title STRING  Title for windows opened from thumbnail mode
72 -I, --fullindex           Index mode with additional image information
73     --index-info FORMAT   Show FORMAT below images in index/thumbnail mode
74     --bg-center FILE      Set FILE as centered desktop background
75     --bg-fill FILE        Like --bg-scale, but preserves aspect ratio by
76                           zooming the image until it fits. May cut off
77                           corners
78     --bg-max FILE         Like --bg-fill, but scale the image to the maximum
79                           size that fits the screen with black borders on one
80                           side
81     --bg-scale FILE       Set FILE as scaled desktop background. This will
82                           fill the whole background, but the images' aspect
83                           ratio may not be preserved
84     --bg-tile FILE        Set FILE as tiled desktop background
85     --no-fehbg            Do not write a ~/.fehbg file
86 -C, --fontpath PATH       Specify an extra directory to look in for fonts,
87                           can be used multiple times to add multiple paths.
88 -M, --menu-font FONT      Use FONT for the font in menus.
89 -B, --image-bg STYLE      Set background for transparent images and the like.
90                           Accepted values: default, checks, or a XColor (eg. #428bdd)
91     --xinerama-index I    Assumee that I is the active xinerama screen
92 -N, --no-menus            Don't load or show any menus.
93     --no-xinerama         Disable Xinerama support
94     --no-screen-clip      Do not limit window size to screen size
95 -Y, --hide-pointer        Hide the pointer
96     --conversion-timeout  INT  Load unknown files with dcraw or ImageMagick,
97                           timeout after INT seconds (0: no timeout)
98     --min-dimension WxH   Only show images with width >= W and height >= H
99     --max-dimension WxH   Only show images with width <= W and height <= H
100     --scroll-step COUNT   scroll COUNT pixels when movement key is pressed
101     --cache-size NUM      imlib cache size in mebibytes (0 .. 2048)
102     --auto-reload         automatically reload shown image if file was changed
103
104MONTAGE MODE OPTIONS
105 -X, --ignore-aspect       Set thumbnail to specified width/height without
106                           retaining aspect ratio
107 -s, --stretch             Scale up images if they are smaller than the
108                           specified thumbnail size
109 -y, --thumb-width NUM     Set thumbnail width in pixels
110 -E, --thumb-height NUM    Set thumbnail height in pixels
111 -W, --limit-width NUM     Limit the width of the montage in pixels
112 -H, --limit-height NUM    Limit the height of the montage in pixels
113                           (at least one of these two must be specified)
114 -b, --bg FILE|trans       Set montage background
115 -a, --alpha NUM           Set thumbnail transparency level (0 .. 255)
116 -o, --output FILE         Save the created montage to FILE
117 -O, --output-only  FILE   Just save the created montage to FILE
118                           WITHOUT displaying it
119 -e, --font FONT           Set font for thumbnail information, in the form
120                           fontname/pointsize
121
122INDEX MODE OPTIONS
123 -@, --title-font FONT     Use FONT to print a title on the index, if no
124                           font is specified, a title will not be printed
125
126FORMAT SPECIFIERS
127 %a     information about slideshow state (playing/paused)
128 %f     image path/filename
129 %F     image path/filename (shell-escaped)
130 %g     window dimensions (\"width,height\") in pixels
131 %h     image height
132 %l     total number of files in the filelist
133 %L     path to temporary copy of filelist
134 %m     current mode (slideshow, multiwindow...)
135 %n     image name
136 %N     image name (shell-escaped)
137 %o     offset of top-left image corner to window (\"x,y\") in pixels
138 %p     image pixel size
139 %P     image pixel size in kilo-/megapixels
140 %r     image rotation. half right turn == 3.1415 (pi)
141 %s     image size in bytes
142 %S     image size with appropriate unit (kB/MB)
143 %t     image format
144 %u     current file number
145 %w     image width
146 %v     " PACKAGE " version
147 %V     process ID
148 %z     current image zoom, rounded to two decimal places
149 %Z     current image zoom, high precision
150 %%     %
151 \\n     newline
152
153DEFAULT KEYS
154 a                       Toggle action display (--draw-actions)
155 A                       Toggle anti-aliasing
156 c                       Enable caption entry mode
157 d                       Toggle filename display (--draw-filename)
158 e                       Toggle exif tag display (if compiled with exif=1)
159 f                       Toggle fullscreen
160 g                       Toggle fixed geometry mode
161 h                       pause/continue slideshow
162 i                       Toggle --info display
163 k                       Toggle zoom/viewport freeze when switching images
164 L                       Save current filelist to unique filename
165 m                       Show/hide menu
166 n, <SPACE>, <RIGHT>     Go to next image
167 o                       Toggle pointer visibility
168 p, <BACKSPACE>, <LEFT>  Go to previous image
169 q, <ESCAPE>             Quit
170 r                       Reload image
171 R                       Render/anti-alias image
172 s                       Save current image to unique filename
173 w                       Resize window to current image dimensions
174 x                       Close current window
175 z                       Jump to a random position in the current filelist
176 Z                       Toggle auto-zoom
177 [, ]                    Jump to previous/next directory
178 <, >                    Rotate 90 degrees right/left
179 _                       Vertical flip
180 |                       Horizontal flip
181 0, <ENTER>              Run action specified by --action option
182 1-9                     Run action 1-9 specified by --action[1-9] options
183 <HOME>                  Go to first slide
184 <END>                   Go to last slide
185 <PAGEUP>                Go forward 5% of the filelist
186 <PAGEDOWN>              Go backward 5% of the filelist
187 +                       Increase reload delay by 1 second
188 -                       Decrease reload delay by 1 second
189 <DELETE>                Remove the currently viewed file from the filelist
190 <CTRL+DELETE>           Like <DELETE>, but also removes the file from the
191                         filesystem. Caution: Does not ask for confirmation
192 <KEYPAD LEFT>           Move the image to the left
193 <KEYPAD RIGHT>          Move the image to the right
194 <KEYPAD UP>             Move the image up
195 <KEYPAD DOWN>           Move the image down
196 <KEYPAD BEGIN>          Antialias the image
197 <KEYPAD +>, <UP>        Zoom in
198 <KEYPAD ->, <DOWN>      Zoom out
199 <KEYPAD *>              Zoom to 100%
200 <KEYPAD />              Zoom to fit the window
201
202This program is free software, see the file COPYING for licensing info.
203Copyright Tom Gilbert (and various contributors) 1999-2003.
204Copyright Daniel Friesel (and various contributors) 2010-2020.
205
206Homepage: http://feh.finalrewind.org
207Report bugs to <derf+feh@finalrewind.org> or #feh on irc.oftc.net.
208