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>