Usage : feh [OPTIONS]... FILES...
Where a FILE is an imlib 2 readable image file or a directory.
Multiple files are supported.
Urls are supported. They must begin with http:// or ftp://and you must have
wget installed to download the files for viewing.
Options can also be defined in the in the feh configuration file. See
man feh for more details
-h, --help display this help and exit
-v, --version output version information and exit
-V, --verbose output useful information, progress bars, etc
-q, --quiet Don't report non-fatal errors for failed loads
Verbose and quiet modes are not mutually exclusive,
the first controls informational messages, the
second only errors.
-T, --theme THEME Load options from config file with name THEME
see man feh for more info.
--rcfile FILE Use FILE to parse themes and options from,
instead of the default ~/.fehrc, /etc/fehrc files.
-r, --recursive Recursively expand any directories in FILE to
the content of those directories. (Take it easy)
-z, --randomize When viewing multiple files in a slideshow,
randomise the file list before displaying
-g, --geometry STRING Limit (and don't change) the window size. Takes
an X-style geometry string like 640x480.
Note that larger images will be zoomed out to fit
but you can see them at 1:1 by clicking the zoom
button.
-f, --filelist FILE This option is similar to the playlists used by
music software. If FILE exists, it will be read
for a list of files to load, in the order they
appear. The format is a list of image filenames,
absolute or relative to the current directory,
one filename per line.
If FILE doesn't exist, it will be created from the
internal filelist at the end of a viewing session.
This is best used to store the results of complex
sorts (-Spixels for example) for later viewing.
Any changes to the internal filelist (such as
deleting a file or it being pruned for being
unloadable) will be saved to FILE when feh exits.
You can add files to filelists by specifying them
on the commandline when also specifying the list.
-p, --preload Preload images. This doesn't mean hold them in
RAM, it means run through and eliminate unloadable
images first. Otherwise they will be removed as you
flick through.
--scale-down Automatically scale down images too big for the
screen. Currently only works with -P
-F, --full-screen Make the window fullscreen
-Z, --auto-zoom Zoom picture to screen size in fullscreen mode,
is affected by the option --stretch
--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.
-w, --multiwindow Disable slideshow mode. With this setting,
instead of opening multiple files in slideshow
mode, multiple windows will be opened.
-x, --borderless Create borderless windows
-d, --draw-filename Draw the filename at the top-left of the image.
--title TITLE Use TITLE as the window title in slideshow mode.
-D, --slideshow-delay NUM For slideshow mode, specifies time delay (seconds,
can be a decimal) between automatically changing
slides.
-R, --reload NUM Use this option to tell feh to reload an image
after NUM seconds. Useful for viewing webcams
via http, or even on your local machine.
-Q, --builtin Use builtin http grabber to grab remote files
instead of wget.
mechanism, useful if you need to use a proxy or
something.
-k, --keep-http When viewing files using http, feh normally
deletes the local copies after viewing, or,
if caching, on exit. This option prevents this
so that you get to keep the local copies.
They will be in the current working directory
with "feh" in the name.
-j, --output-dir Output directory for saved files. Really only
useful with the -k flag.
-G, --wget-timestamp When viewing http images with reload set (eg
webcams), try to only reload the image if the
remote file has changed.
-l, --list Don't display images. Analyse them and display an
'ls' style listing. Useful in scripts hunt out
images of a certain size/resolution/type etc.
-L, --customlist FORMAT Use FORMAT as the format specifier for list
output. FORMAT is a printf-like string containing
image info specifiers. See FORMAT SPECIFIERS.
-U, --loadable Don't display images. Just print out their name
if imlib2 can successfully load them.
-u, --unloadable Don't display images. Just print out their name
if imlib2 can NOT successfully load them.
-S, --sort SORT_TYPE The file list may be sorted according to image
parameters. Allowed sort types are: name,
filename, width, height, pixels, size, format.
For sort modes other than name or filename, a
preload run will be necessary, causing a delay
proportional to the number of images in the list
-n, --reverse Reverse the sort order. Use this to invert the order
of the filelist. Eg to sort in reverse width order,
use -nSwidth
-A, --action ACTION Specify a string as an action to perform on the
image. In slideshow or multiwindow modes, the action
will be run when the enter key is pressed, in list
mode, or loadable|unloadable modes, the action will
be run for each file.
The action will be executed by /bin/sh. Use
format specifiers to refer to image info. See
FORMAT SPECIFIERS for examples
Eg. -X "mv %f ~/images/%n"
In slideshow mode, the next image will be shown
after running the command, in multiwindow mode,
the window will be closed.
-m, --montage Enable montage mode. Montage mode creates a new
image consisting of a grid of thumbnails of the
images specified using FILE... When montage mode
is selected, certain other options become
available. See MONTAGE MODE OPTIONS
-c, --collage Same as montage mode, but the thumbnails are
distributed randomly. You must specify width and
height or supply a background image or both
-i, --index Enable Index mode. Index mode is similar to
montage mode, and accepts the same options. It
creates an index print of thumbails, printing the
images name beneath each thumbnail. Index mode
enables certain other options, see INDEX MODE
OPTIONS
-t, --thumbnails As --index, but clicking an image will open it in
a new viewing window
-I, --fullindex Same as index mode, but below each thumbnail you
get image name, size and dimensions
--bg-tile FILE
--bg-center FILE
--bg-scale FILE
--bg-seamless FILE Set your desktop background to FILE. Feh can
use enlightenment IPC if you are running it,
or will fall back to X methods.
Feh stores the commandline necessary to restore
the background you chose in ~/.fehbg. So to have
feh-set backgrounds restored when you restart X,
add the line "eval `cat $HOME/.fehbg`" to your
X startup script (e.g. ~/.xsession). Note that
you only need to do this for non E window
managers.
--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.
-N, --no-menus Don't load or show any menus.
-1, --next-button B Use button B to advance to the next image in any
mode (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).
-4, --menu-button B Use CTRL+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).
-5, --menu-ctrl-mask Require CTRL+Button for menu activation in
any mode (default=off).
-6, --rotate-button B Use CTRL+Button B to rotate the current image in
any mode (default=2).
-7, --no-rotate-ctrl-mask Don't require CTRL+Button for rotation in
any mode -- just use the button (default=off).
-8, --blur-button B Use CTRL+Button B to blur the current image in
any mode (default=1).
-9, --no-blur-ctrl-mask Don't require CTRL+Button for blurring in
any mode -- just use the button (default=off).
FORMAT SPECIFIERS
%f image path/filename
%n image name
%s image size (bytes)
%p image pixel size
%w image width
%h image height
%t image format
%P prints feh
%v prints the version
%m prints the mode (slideshow, multiwindow...)
%l prints the total number of files in the filelist
%u prints the current file number
\n prints a newline
Eg. feh -A "mv %f ~/images/%n" *
MONTAGE MODE OPTIONS
-X, --ignore-aspect By default, the montage thumbnails will retain
their aspect ratios, while fitting in --thumb-width
and --thumb-height. This option will force them to
be the size set by --thumb-width and --thumb-height
This will prevent any whitespace in the final
montage
-s, --stretch Normally, if an image is smaller than the specified
thumbnail size, it will not be enlarged. If this
option is set, the image will be scaled up to fit
the thumbnail size. (Aspect ratio will be maintained
unless --ignore-aspect is specified)
-y, --thumb-width NUM Set thumbnail width in pixels
-E, --thumb-height NUM Set thumbnail height in pixels
Thumbnails default to 20x20 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
These options can be used together (to define the
image size exactly), or separately. If only one is
specified, theother is calculated from the number
of files specified and the size of the thumbnails.
The default is to limit width to 800 pixels and
calculate the height
-b, --bg FILE|trans Use FILE as a background for your montage. With
this option specified, the size of the montage will
default to the size of FILE if no size restrictions
are specified. Alternatively, if FILE is "trans",
make the background transparent.
-a, --alpha NUM When drawing thumbnails onto the background, apply
them with a transparency level of NUM (0-255).
-o FILE Save the created montage to FILE
-O FILE Just save the created montage to FILE
WITHOUT displaying it (use in scripts)
INDEX MODE OPTIONS
-e FONT Use FONT to print the information under each
thumbnail. FONT should be defined in the form
fontname/size(points). eg -e myfont/12
-t,--title-font FONT Use FONT to print a title on the index, if no
font is specified, a title will not be printed
SLIDESHOW KEYS
The default mode for viewing mulitple images is Slideshow mode
When viewing a slideshow, the following keys may be used:
p, P, <BACKSPACE>, <LEFT> Goto previous slide
n, N, <SPACE>, <RIGHT> Goto next slide
r, R Reload image (good for webcams)
w, W Size window to current image dimensions
h, H Pause the slideshow (only useful when using
s, S Save current image to unique filename
f, F Save current filelist to unique filename
timed reloading or image changes)
<, > In place editing, rotate 90 degrees right/left
<HOME> Goto first slide
<END> Goto last slide
+, = Increase reload delay
-, _ Decrease reload delay
<DELETE> Remove the currently viewed file from the filelist
<CTRL+DELETE> Delete the currently viewed file and remove it
from the filelist
x, X Close current window
q, Q Quit the slideshow
MOUSE ACTIONS
When viewing an image, a click of mouse button 1 moves to the next image
(slideshow mode only), a drag of mouse button 1 pans the image, if the
viewable window is smaller than the image, button 2 zooms (click and drag
left->right to zoom in, right->left to zoom out, click once to restore
1x zoom), and mouse button 3 pans.
Ctrl+button 1 blurs or sharpens the image (drag left to blur and right to
sharpen). Ctrl+button 2 rotates the image around the center point.
Button 3 activates the context-sensitive menu. Buttons can be redefined
with the -1 through -9 (or --*-button) cmdline flags. All you people
with million button mice can remove the ctrl mask with the --no-*-ctrl-mask
options.
See 'man feh' for more detailed information
This program is free software see the file COPYING for licensing info.
Copyright Tom Gilbert (and various contributors) 1999, 2000
Email bugs to <feh_sucks@linuxbrit.co.uk>
