1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
|
" PACKAGE " version " VERSION "
Usage : " PACKAGE " [options] <files or directories ...>
This is just a short option summary. Please see \"man " PACKAGE "\" for details.
OPTIONS
-h, --help Show help and exit
-v, --version Show version information and exit
-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
-r, --recursive Recursively expand any directories in FILE to
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 WxH[+X+Y] Limit the window size to DIMENSION[+OFFSET]
-f, --filelist FILE Load/save images from/to the FILE 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 screen size
-F, --fullscreen Make the window full screen
-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. Also support \"max\" and \"fill\"
--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
--on-last-slide quit Exit after one loop through the slide show
--on-last-slide hold Stop at both ends of the filelist
-R, --reload NUM Reload images after NUM seconds
-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
-L, --customlist FORMAT list mode with custom output, see FORMAT SPECIFIERS
-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, mtime, width, height, pixels, size,
or format
-n, --reverse Reverse sort order
--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>
-G, --draw-actions Show the defined actions in the image window
--force-aliasing Disable antialiasing
-m, --montage Enable montage mode
-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
-P, --cache-thumbnails Enable thumbnail caching for thumbnail mode.
Only works with thumbnails <= 256x256 pixels
-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-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
corners
--bg-max FILE Like --bg-fill, but scale the image to the maximum
size that fits the screen with black borders on one
side
--bg-scale FILE Set FILE as scaled desktop background. This will
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.
-B, --image-bg STYLE Set background for transparent images and the like.
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.
--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)
MONTAGE MODE OPTIONS
-X, --ignore-aspect Set thumbnail to specified width/height without
retaining aspect ratio
-s, --stretch Scale up images if they are smaller than the
specified thumbnail size
-y, --thumb-width NUM Set thumbnail width in pixels
-E, --thumb-height NUM Set thumbnail height in pixels
-W, --limit-width NUM Limit the width of the montage in pixels
-H, --limit-height NUM Limit the height of the montage in pixels
(at least one of these two must be specified)
-b, --bg FILE|trans Set montage background
-a, --alpha NUM Set thumbnail transparency level (0 .. 255)
-o, --output FILE Save the created montage to FILE
-O, --output-only FILE Just save the created montage to FILE
WITHOUT displaying it
-e, --font FONT Set font for thumbnail information, in the form
fontname/pointsize
INDEX MODE OPTIONS
-@, --title-font FONT Use FONT to print a title on the index, if no
font is specified, a title will not be printed
FORMAT SPECIFIERS
%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
%N image name (shell-escaped)
%o offset of top-left image corner to window (\"x,y\") in pixels
%p image pixel size
%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
%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
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
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
<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
<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 *> Zoom to 100%
<KEYPAD /> Zoom to fit the window
This program is free software, see the file COPYING for licensing info.
Copyright Tom Gilbert (and various contributors) 1999-2003.
Copyright Daniel Friesel (and various contributors) 2010-2018.
Homepage: http://feh.finalrewind.org
Report bugs to <derf+feh@finalrewind.org> or #feh on irc.oftc.net.
|