"Fossies" - the Fresh Open Source Software Archive

Member "feh-3.4.1/man/feh.pre" (29 May 2020, 47939 Bytes) of package /linux/privat/feh-3.4.1.tar.bz2:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "feh.pre": 3.4_vs_3.4.1.

    1 .Dd $DATE$
    2 .Dt FEH 1
    3 .Os
    4 .
    5 .
    6 .Sh NAME
    7 .
    8 .Nm feh
    9 .Nd image viewer and cataloguer
   10 .
   11 .
   12 .Sh SYNOPSIS
   13 .
   14 .Nm
   15 .Op Ar options
   16 .Op Ar files | Ar directories | Ar URLs ...
   17 .
   18 .
   19 .Sh VERSION
   20 .
   21 This manual documents
   22 .Nm
   23 $VERSION$
   24 .
   25 .Pp
   26 .
   27 Compile-time switches in this build:
   28 .
   29 .Bl -bullet -compact
   30 .
   31 .It
   32 remote file support: libcurl $MAN_CURL$
   33 .
   34 .It
   35 natural sorting option $MAN_VERSCMP$
   36 .
   37 .It
   38 Xinerama multi-monitor support $MAN_XINERAMA$
   39 .
   40 .It
   41 builtin EXIF reader $MAN_EXIF$
   42 .
   43 .It
   44 inotify-based auto-reload of changed files $MAN_INOTIFY$
   45 .
   46 .El
   47 .
   48 $MAN_DEBUG$
   49 .
   50 .
   51 .Sh DESCRIPTION
   52 .
   53 .Nm
   54 is a light-weight, configurable and versatile image viewer.
   55 It is aimed at command line users, but can also be started from graphical file
   56 managers.
   57 Apart from viewing images, it can compile text and thumbnail
   58 listings, show (un)loadable files, set X11 backgrounds, and more.
   59 .
   60 .Pp
   61 .
   62 Features include filelists, various image sorting modes, custom action scripts,
   63 and image captions.
   64 .Nm
   65 can be controlled by configurable keyboard and mouse shortcuts, terminal
   66 input and signals.
   67 When no file arguments or filelists are specified and
   68 .Cm --start-at
   69 is not used,
   70 .Nm
   71 displays all files in the current directory.
   72 .
   73 .Pp
   74 .
   75 EXIF tags are supported either using exiv2 / exifgrep via
   76 .Cm --info
   77 .Pq see the Sx USAGE EXAMPLES No section ,
   78 or as a builtin feature by compiling
   79 .Nm
   80 with exif=1. In this build of
   81 .Nm ,
   82 builtin EXIF support is $MAN_EXIF$.
   83 .
   84 .
   85 .Sh MODES
   86 .
   87 .Nm
   88 is based on various modes, which are selected at startup by command line
   89 options.
   90 .
   91 .Pp
   92 .
   93 Slideshow mode is the default.
   94 It opens a window and displays the first image in it;
   95 the slideshow position can be advanced
   96 .Pq or otherwise changed
   97 using keyboard and mouse shortcuts.
   98 In slideshow mode, images can be deleted either from the filelist or from the
   99 disk, a changed filelist can also be saved to the disk and reopened at a later
  100 time.
  101 An image can also be read from stdin via
  102 .Qq feh - .
  103 .
  104 .Pp
  105 .
  106 Montage mode forms a montage from the filelist.
  107 The resulting image can be viewed or saved,
  108 and its size can be limited by height, width or both.
  109 .
  110 .Pp
  111 .
  112 Index mode forms an index print from the filelist.
  113 Image thumbnails are shown along with the filename,
  114 size and dimensions, printed using a truetype
  115 font of your choice.
  116 The resulting image can be viewed or saved, and its size
  117 can be limited by height, width or both.
  118 .
  119 .Pp
  120 .
  121 Thumbnail mode is like index mode, but the mini-images are clickable and open
  122 the selected image in a new window.
  123 .
  124 .Pp
  125 .
  126 Multiwindow mode shows images in multiple windows, instead of as a slideshow
  127 in one window.
  128 Don't use with a large filelist ;)
  129 .
  130 .Pp
  131 .
  132 List mode doesn't display images.
  133 Instead, it outputs an
  134 .Cm ls Ns No - Ns style
  135 listing of the files in the filelist, including image info such as size, number
  136 of pixels, type, etc.
  137 There is also a Customlist mode which prints image info
  138 in a custom format specified by a printf-like format string.
  139 .
  140 .Pp
  141 .
  142 .Nm
  143 can also list either all the loadable files in a filelist or all the
  144 unloadable files.
  145 This is useful for preening a directory.
  146 .
  147 .
  148 .Sh SUPPORTED FORMATS
  149 .
  150 .Nm
  151 can open any format supported by imlib2, most notably jpeg, png,
  152 pnm, tiff, and bmp.
  153 The gif format is also supported, but only for static images.
  154 In case of animations, only the first frame will be shown.
  155 .
  156 If the convert binary
  157 .Pq supplied by ImageMagick
  158 is available, it also has limited support for many other file types, such as
  159 svg, xcf and otf.
  160 If dcraw is available,
  161 .Nm
  162 also supports RAW files provided by cameras and will display the embedded
  163 thumbnails.
  164 Use
  165 .Cm --conversion-timeout Ar timeout
  166 with a non-negative value to enable support for these formats.
  167 .
  168 .
  169 .Sh OPTIONS
  170 .
  171 .Bl -tag -width indent
  172 .
  173 .It Cm -A , --action Oo Ar flag Oc Ns Oo [ Ar title ] Oc Ns Ar action
  174 .
  175 Specify a shell command as an action to perform on the image.
  176 In slideshow or multiwindow mode, the action will be run when
  177 the action_0 key is pressed, in list mode, it will be run for each file.
  178 In loadable/unloadable mode, it will be run for each loadable/unloadable
  179 file, respectively.
  180 In thumbnail mode, clicking on an image will cause the action to run instead
  181 of opening the image.
  182 .
  183 .Pp
  184 .
  185 If
  186 .Ar flag
  187 is
  188 .Qq \&; ,
  189 .Nm
  190 will reload the current image instead of switching to the next one
  191 .Pq slideshow mode
  192 or closing the window
  193 .Pq multiwindow mode
  194 after
  195 executing the action.
  196 .
  197 If
  198 .Ar [ title ]
  199 is specified
  200 .Pq note the literal Qo \&[ Qc and Qo ] Qc ,
  201 .Cm --draw-actions
  202 will display
  203 .Ar title
  204 instead of
  205 .Ar action
  206 in the action list.
  207 Note that
  208 .Ar title
  209 must not start with a space.
  210 If it does, the action is handled as if it did not have a title.
  211 This special case exists for backwards compatibility reasons
  212 and makes sure that actions like
  213 .Qq \&[ -L %F \&] && foo
  214 still work.
  215 .
  216 .
  217 .Pp
  218 .
  219 The action will be executed by /bin/sh.
  220 Use format specifiers to refer to image info, see
  221 .Sx FORMAT SPECIFIERS
  222 for details.
  223 Example usage:
  224 .Qq feh -A Qo mv ~/images/%N Qc * .
  225 .
  226 .It Cm --action1 No .. Cm --action9 Oo Ar flag Oc Ns Oo [ Ar title ] Oc Ns Ar action
  227 .
  228 Extra actions which can be set and triggered using the appropriate number key.
  229 .
  230 .It Cm --auto-reload
  231 .
  232 .Pq optional feature, $MAN_INOTIFY$ in this build
  233 automatically reload image when the underlying file changes.
  234 Note that auto-reload
  235 .Pq if enabled in the build
  236 is on by default.
  237 This option is only useful to re-enable auto-reload after it has been
  238 disabled by a preceding
  239 .Cm --reload=0
  240 option.
  241 .
  242 .It Cm --auto-rotate
  243 .
  244 .Pq optional feature, $MAN_EXIF$ in this build
  245 Automatically rotate images based on EXIF data.
  246 Does not alter the image files.
  247 .
  248 .It Cm -Z , --auto-zoom
  249 .
  250 Zoom pictures to screen size in fullscreen / fixed geometry mode.
  251 .
  252 .It Cm -x , --borderless
  253 .
  254 Create borderless windows.
  255 .
  256 .It Cm --cache-size Ar size
  257 .
  258 Set imlib2 in-memory cache to
  259 .Ar size
  260 MiB.
  261 A higher cache size can significantly improve performance especially for small
  262 slide shows, however at the cost of increased memory consumption.
  263 .Ar size
  264 must be between 0 and 2048 MiB and defaults to 4.
  265 .
  266 .It Cm -P , --cache-thumbnails
  267 .
  268 Enable thumbnail caching.
  269 Thumbnails are saved in
  270 .Pa $XDG_CACHE_HOME/thumbnails ,
  271 which defaults to
  272 .Pa ~/.cache/thumbnails .
  273 Note that thumbnails are only cached if the configured thumbnail size does
  274 not exceed 256x256 pixels.
  275 .
  276 .It Cm -K , --caption-path Ar path
  277 .
  278 Path to directory containing image captions.
  279 This turns on caption viewing, and if captions are found in
  280 .Ar path ,
  281 which is relative to the directory of each image, they are overlayed on the
  282 displayed image.
  283 E.g. with caption path
  284 .Qq captions/ ,
  285 and viewing image
  286 .Qq images/foo.jpg ,
  287 the caption will be looked for in
  288 .Qq images/captions/foo.jpg.txt .
  289 .
  290 .It Cm --conversion-timeout Ar timeout
  291 .
  292 .Nm
  293 can use ImageMagick to try converting unloadable files into a supported
  294 file format.
  295 As this can take a long time, it is disabled by default.
  296 Set
  297 .Ar timeout
  298 to a non-negative value to enable it.
  299 A positive value
  300 specifies after how many seconds conversion attempts should be aborted,
  301 zero causes
  302 .Nm
  303 to try indefinitely.
  304 Negative values restore the default by disabling conversion altogether.
  305 .
  306 .It Cm --class Ar class
  307 .
  308 Set the X11 class hint to
  309 .Ar class .
  310 .
  311 Default: feh
  312 .
  313 .It Cm -L , --customlist Ar format
  314 .
  315 Don't display images, print image info according to
  316 .Ar format
  317 instead.
  318 See
  319 .Sx FORMAT SPECIFIERS .
  320 .
  321 .It Cm -G , --draw-actions
  322 .
  323 Draw the defined actions and what they do at the top-left of the image.
  324 .
  325 .It Cm --draw-exif
  326 .
  327 .Pq optional feature, $MAN_EXIF$ in this build
  328 display some EXIF information in the bottom left corner, similar to using
  329 .Cm --info
  330 with exiv2 / exifgrep.
  331 .
  332 .It Cm -d , --draw-filename
  333 .
  334 Draw the file name at the top-left of the image.
  335 .
  336 .It Cm --draw-tinted
  337 .
  338 Show overlay texts
  339 .Pq as created by Cm --draw-filename No et al
  340 on a semi-transparent background to improve their readability.
  341 .
  342 .It Cm --edit
  343 .
  344 Enable basic editing of files.
  345 This makes rotation and mirroring
  346 .Pq bound to Qo < Qc , Qo > Qc , Qo | Qc , and Qo _ Qc by default
  347 change the underlying file and not just its displayed content.
  348 .
  349 .It Cm -f , --filelist Ar file
  350 .
  351 This option is similar to the playlists used by music software.
  352 If
  353 .Ar file
  354 exists, it will be read for a list of files to load, in the order they appear.
  355 The format is a list of image file names, absolute or relative to the current
  356 directory, one file name per line.
  357 .
  358 .Pp
  359 .
  360 If
  361 .Ar file
  362 doesn't exist, it will be created from the internal filelist at the end of a
  363 viewing session.
  364 This is best used to store the results of complex sorts
  365 .Pq Cm -Spixels No for example
  366 for later viewing.
  367 .
  368 .Pp
  369 .
  370 Any changes to the internal filelist
  371 .Pq such as deleting a file or it being pruned for being unloadable
  372 will be saved to
  373 .Ar file
  374 when
  375 .Nm
  376 exits.
  377 You can add files to filelists by specifying them on the command line
  378 when also specifying the list.
  379 .
  380 .Pp
  381 .
  382 If
  383 .Ar file
  384 is
  385 .Qq - ,
  386 .Nm
  387 will read the filelist from its standard input.
  388 .
  389 .It Cm -e , --font Ar font
  390 .
  391 Set global font.
  392 Should be a truetype font, resident in the current directory or the font
  393 directory, and should be defined in the form fontname/points, like
  394 .Qq myfont/12 .
  395 .
  396 .It Cm -C , --fontpath Ar path
  397 .
  398 Specify
  399 .Ar path
  400 as extra directory in which to search for fonts; can be used multiple times to
  401 add multiple paths.
  402 .
  403 .It Cm --force-aliasing
  404 .
  405 Disable anti-aliasing for zooming, background setting etc.
  406 .
  407 .It Cm -I , --fullindex
  408 .
  409 Same as index mode, but with additional information below the thumbnails.
  410 Works just like
  411 .Qq feh --index --index-info \&"\&%n\en\&%S\en\&%wx\&%h\&" .
  412 Enables
  413 .Sx MONTAGE MODE OPTIONS .
  414 .
  415 .Pp
  416 .
  417 Note: This option needs to load all images to calculate the dimensions of the
  418 .Nm
  419 window, so when using it with many files it will take a while before a
  420 .Nm
  421 window is visible.
  422 Use
  423 .Cm --preload
  424 to get a progress bar.
  425 .
  426 .It Cm -F , --fullscreen
  427 .
  428 Make the window fullscreen.
  429 Note that in this mode, large images will always be scaled down to fit the
  430 screen, and
  431 .Cm --zoom Ar zoom
  432 only affects smaller images and never scales larger than necessary to fit the
  433 screen size.
  434 The only exception is a
  435 .Ar zoom
  436 of 100, in which case images will always be shown at 100% zoom.
  437 .
  438 .Pp
  439 .
  440 When combined with
  441 .Cm --thumbnails ,
  442 this option only affects images opened from the thumbnail overview.
  443 The thumbnail list itself will still be windowed.
  444 .
  445 .It Cm -g , --geometry Ar width Cm x Ar height | Cm + Ar x Cm + Ar y | Ar width Cm x Ar height Cm + Ar x Cm + Ar y
  446 .
  447 Use a fixed window size as specified in the X-style geometry
  448 .Ar string ,
  449 e.g. 640x480.
  450 An optional +x+y window offset can be specified.
  451 Combine with
  452 .Cm --scale-down
  453 to scale down larger images like in fullscreen mode.
  454 .
  455 Note that this option does not enforce the window size; changing it by a tiling
  456 WM or manually is still possible.
  457 However, auto-resize remains disabled.
  458 .
  459 .It Cm -Y , --hide-pointer
  460 .
  461 Hide the pointer
  462 .Pq useful for slideshows .
  463 .
  464 .It Cm -B , --image-bg Ar style
  465 .
  466 Use
  467 .Ar style
  468 as background for transparent image parts and the like.
  469 Accepted values: default, checks, or an XColor
  470 .Pq e.g. Qo black Qc or Qo #428bdd Qc .
  471 Note that some shells treat the hash symbol as a special character, so you
  472 may need to quote or escape it for the XColor code to work.
  473 .
  474 In windowed mode, the default is checks
  475 .Pq a checkered background so transparent image parts are easy to see .
  476 In fullscreen and background setting mode,
  477 .Cm checks
  478 is not accepted and the default is black.
  479 .
  480 .It Cm -i , --index
  481 .
  482 Enable Index mode.
  483 Index mode is similar to montage mode, and accepts the same options.
  484 It creates an index print of thumbnails, printing the image name beneath
  485 each thumbnail.
  486 Index mode enables certain other options, see
  487 .Sx INDEX AND THUMBNAIL MODE OPTIONS
  488 and
  489 .Sx MONTAGE MODE OPTIONS .
  490 .
  491 .It Cm --info Oo Ar flag Oc Ns Ar command_line
  492 .
  493 Execute
  494 .Ar command_line
  495 and display its output in the bottom left corner of the image.
  496 Can be used to display e.g. image dimensions or EXIF information.
  497 Supports
  498 .Sx FORMAT SPECIFIERS .
  499 .
  500 If
  501 .Ar flag
  502 is set to
  503 .Qo ; Qc ,
  504 the output will not be displayed by default, but has to be enabled by the
  505 toggle_info key.
  506 .
  507 .It Cm --insecure
  508 .
  509 When viewing files with HTTPS, this option disables all certificate checks.
  510 It allows images on sites with self-signed or expired certificates to be
  511 opened, but is no more secure than plain HTTP.
  512 .
  513 .It Cm -k , --keep-http
  514 .
  515 When viewing files using HTTP,
  516 .Nm
  517 normally deletes the local copies after viewing, or, if caching, on exit.
  518 This option permanently stores them on disk, either in the directory
  519 specified by
  520 .Cm --output-dir ,
  521 or in the current working directory.
  522 .
  523 .It Cm --keep-zoom-vp
  524 .
  525 When switching images, keep zoom and viewport settings
  526 .Pq zoom level and X, Y offsets
  527 .
  528 .It Cm -l , --list
  529 .
  530 Don't display images.
  531 Analyze them and display an
  532 .Xr ls 1 - No style
  533 listing.
  534 Useful in scripts to hunt out images of a certain size/resolution/type etc.
  535 .
  536 .It Cm -U , --loadable
  537 .
  538 Don't display images.
  539 Just print out their names if imlib2 can successfully load them.
  540 Returns false if at least one image failed to load.
  541 .
  542 .It Cm --max-dimension Ar width No x Ar height
  543 .
  544 Only show images with width <=
  545 .Ar width
  546 and height <=
  547 .Ar height .
  548 If you only care about one parameter, set the other to 0
  549 .Pq or a negative value .
  550 .
  551 .It Cm -M , --menu-font Ar font
  552 .
  553 Use
  554 .Ar font
  555 .Pq truetype, with size, like Qq yudit/12
  556 as menu font.
  557 .
  558 .It Cm --min-dimension Ar width No x Ar height
  559 .
  560 Only show images with width >=
  561 .Ar width
  562 and height >=
  563 .Ar height .
  564 If you only care about one parameter, set the other to 0.
  565 .
  566 .It Cm -m , --montage
  567 .
  568 Enable montage mode.
  569 Montage mode creates a new image consisting of a grid of thumbnails of the
  570 images in the filelist.
  571 When montage mode is selected, certain other options become available.
  572 See
  573 .Sx MONTAGE MODE OPTIONS .
  574 .
  575 .It Cm -w , --multiwindow
  576 .
  577 Disable slideshow mode.
  578 With this setting, instead of opening multiple files in slideshow mode,
  579 multiple windows will be opened; one per file.
  580 .
  581 .It Cm --no-conversion-cache
  582 .
  583 When loading images via HTTP, ImageMagick or dcraw,
  584 .Nm
  585 will only load/convert them once and re-use the cached file on subsequent
  586 slideshow passes.
  587 This option disables the cache. It is also disabled when
  588 .Cm --reload
  589 is used.
  590 Use it if you rely on frequently changing files loaded via one of these
  591 sources.
  592 Note that it will impair performance.
  593 .
  594 .It Cm --no-jump-on-resort
  595 .
  596 Don't jump to the first image after resorting the filelist.
  597 .
  598 .It Cm -N , --no-menus
  599 .
  600 Don't load or show any menus.
  601 .
  602 .It Cm --no-screen-clip
  603 .
  604 By default, window sizes are limited to the screen size.
  605 With this option, windows will have the size of the image inside them.
  606 Note that they may become very large this way, making them unmanageable
  607 in certain window managers.
  608 .
  609 .It Cm --no-xinerama
  610 .
  611 .Pq optional feature, $MAN_XINERAMA$ in this build
  612 Disable Xinerama support.
  613 .
  614 .It Cm --on-last-slide Cm hold | Cm quit | Cm resume
  615 .
  616 Select behaviour when trying to select the next image on the last slide
  617 .Pq or the previous image on the first slide
  618 in a slide show.
  619 .
  620 .Pp
  621 .
  622 With
  623 .Cm hold ,
  624 .Nm
  625 will stop advancing images in this case and continue displaying the first/last
  626 image, respectively.
  627 This is intended for linear slide shows.
  628 Behaviour is unspecified when using other navigation commands than previous
  629 and next image.
  630 .
  631 .Pp
  632 .
  633 .Cm quit
  634 will cause
  635 .Nm
  636 to quit when trying to advance past the last image in the slide show.
  637 .
  638 .Pp
  639 .
  640 .Cm resume
  641 is the default behaviour: On the last
  642 .Pq first
  643 image,
  644 .Nm
  645 will wrap around to the first
  646 .Pq last
  647 image.
  648 .
  649 .It Cm -j , --output-dir Ar directory
  650 .
  651 Save files to
  652 .Ar directory
  653 when using
  654 .Cm --keep-http
  655 or the save_image command.
  656 By default, files are saved in the current working directory.
  657 .
  658 .It Cm -p , --preload
  659 .
  660 Preload images.
  661 This doesn't mean hold them in RAM, it means run through them and eliminate
  662 unloadable images first.
  663 Otherwise they will be removed as you flick through.
  664 This also analyses the images to get data for use in sorting, such as pixel
  665 size, type etc.
  666 A preload run will be automatically performed if you specify one of these
  667 sort modes.
  668 .
  669 .It Cm -q , --quiet
  670 .
  671 Don't report non-fatal errors for failed loads.
  672 Verbose and quiet modes are not mutually exclusive, the first controls
  673 informational messages, the second only errors.
  674 .
  675 .It Cm -z , --randomize
  676 .
  677 When viewing multiple files in a slideshow, randomize the file list before
  678 displaying.
  679 The list is re-randomized whenever the slideshow cycles (that is, transitions
  680 from last to first image).
  681 .
  682 .It Cm -r , --recursive
  683 .
  684 Recursively expand any directories in the command line arguments
  685 to the content of those directories, all the way down to the bottom level.
  686 .
  687 .It Cm --no-recursive
  688 .
  689 Don't recursively expand any directories.
  690 This is the default, but this option is useful to override themes containing
  691 .Cm --recursive .
  692 .
  693 .It Cm -R , --reload Ar int
  694 .
  695 Reload filelist and current image after
  696 .Ar int
  697 seconds.
  698 Useful for viewing HTTP webcams or frequently changing directories.
  699 .Pq Note that filelist reloading is still experimental.
  700 Set to zero to disable any kind of automatic reloading.
  701 .
  702 .Pp
  703 .
  704 If an image is removed,
  705 .Nm
  706 will either show the next one or quit.
  707 However, if an image still exists, but can no longer be loaded,
  708 .Nm
  709 will continue to try loading it.
  710 .
  711 .Pp
  712 .
  713 Setting this option causes inotify-based auto-reload to be disabled.
  714 .
  715 .It Cm -n , --reverse
  716 .
  717 Reverse the sort order.
  718 Use this to invert the order of the filelist.
  719 E.g. to sort in reverse width order, use
  720 .Cm -nSwidth .
  721 .
  722 .It Cm -. , --scale-down
  723 .
  724 Scale images to fit window geometry (defaults to screen size when no geometry
  725 was specified).
  726 Note that the window geometry is not updated when changing images at the moment.
  727 This option is recommended for tiling window managers.
  728 .
  729 This option is ignored when in fullscreen and thumbnail list mode.
  730 .
  731 .Pp
  732 .
  733 In tiling environments, this also causes the image to be centered in the window.
  734 .
  735 .It Cm --scroll-step Ar count
  736 .
  737 Scroll
  738 .Ar count
  739 pixels whenever scroll_up, scroll_down, scroll_left or scroll_right is pressed.
  740 Note that this option accepts negative numbers in case you need to reverse the
  741 scroll direction.
  742 See
  743 .Sx KEYS CONFIG SYNTAX
  744 for how to reverse it permanently.
  745 Default: 20
  746 .
  747 .It Cm -D , --slideshow-delay Ar float
  748 .
  749 For slideshow mode, wait
  750 .Ar float
  751 seconds between automatically changing slides.
  752 Useful for presentations.
  753 Specify a negative number to set the delay
  754 .Pq which will then be Ar float No * (-1) ,
  755 but start
  756 .Nm
  757 in paused mode.
  758 .
  759 .It Cm -S , --sort Ar sort_type
  760 .
  761 Sort file list according to image parameters.
  762 Allowed sort types are:
  763 .Cm name , filename , dirname , mtime , width , height , pixels , size , format .
  764 For sort modes other than
  765 .Cm name , filename , dirname ,
  766 or
  767 .Cm mtime ,
  768 a preload run is
  769 necessary, causing a delay proportional to the number of images in the list.
  770 .
  771 .Pp
  772 .
  773 .Cm mtime
  774 starts with the most recently modified image.
  775 .Cm width , height , pixels
  776 and
  777 .Cm size
  778 start with the smallest.
  779 Use
  780 .Cm --reverse
  781 to sort by oldest or largest first.
  782 .
  783 .Pp
  784 .
  785 For
  786 .Cm name , filename ,
  787 and
  788 .Cm dirname
  789 you can use
  790 .Cm --version-sort
  791 to sort numbers naturally, so that e.g. 10.jpg comes after 2.jpg.
  792 .
  793 .It Cm -| , --start-at Ar filename
  794 .
  795 Start the filelist at
  796 .Ar filename .
  797 If no other files or filelists were specified on the command line,
  798 .Nm
  799 will first load all files from the directory in which
  800 .Ar filename
  801 resides.
  802 This way, it's possible to look at a specific image and use the next / prev
  803 keys to browse through the directory.
  804 See
  805 .Sx USAGE EXAMPLES
  806 for examples.
  807 If
  808 .Ar filename
  809 is a remote URL and no files or filelists were specified,
  810 .Nm
  811 will show
  812 .Ar filename
  813 and not attempt to load additional files or directories.
  814 .
  815 .Pp
  816 .
  817 Note: If you use relative paths in your filelist,
  818 .Ar filename
  819 should also be a relative path.
  820 If you use absolute paths, it should also be an absolute path.
  821 .
  822 If
  823 .Nm
  824 cannot find an exact match, it will compare basenames
  825 .Pq filenames without the directory suffix .
  826 This may lead to mismatches if several files in your filelist
  827 have the same basename.
  828 .
  829 .It Cm -T , --theme Ar theme
  830 .
  831 Load options from config file with name
  832 .Ar theme
  833 - see
  834 .Sx THEMES CONFIG SYNTAX
  835 for more info.
  836 Note that command line options always override theme options.
  837 The theme can also be set via the program name
  838 .Pq e.g. with symlinks ,
  839 so by default
  840 .Nm
  841 will look for a
  842 .Qq Nm
  843 theme.
  844 .
  845 .It Cm -t , --thumbnails
  846 .
  847 Same as Index mode, but the thumbnails are clickable image launchers.
  848 Note that
  849 .Cm --fullscreen
  850 and
  851 .Cm --scale-down
  852 do not affect the thumbnail window.
  853 They do, however, work for image windows launched from thumbnail mode.
  854 Also supports
  855 .Sx INDEX AND THUMBNAIL MODE OPTIONS
  856 as well as
  857 .Sx MONTAGE MODE OPTIONS .
  858 .
  859 .It Cm -~ , --thumb-title Ar string
  860 .
  861 Set
  862 .Ar title
  863 for windows opened from thumbnail mode.
  864 See also
  865 .Sx FORMAT SPECIFIERS .
  866 .
  867 .It Cm -^ , --title Ar title
  868 .
  869 Set window title.
  870 Applies to all windows except those opened from thumbnail mode.
  871 See
  872 .Sx FORMAT SPECIFIERS .
  873 .
  874 .It Cm -u , --unloadable
  875 .
  876 Don't display images.
  877 Just print out their names if imlib2 can NOT successfully load them.
  878 Returns false if at least one image was loadable.
  879 .
  880 .It Cm -V , --verbose
  881 .
  882 output useful information, progress bars, etc.
  883 .
  884 .It Cm -v , --version
  885 .
  886 output version information and exit.
  887 .
  888 .It Cm --version-sort
  889 .
  890 .Pq optional feature, $MAN_VERSCMP$ in this build
  891 When combined with
  892 .Cm --sort name , --sort filename ,
  893 or
  894 .Cm --sort dirname :
  895 use natural sorting for file and directory names.
  896 In this mode, filenames are sorted as an ordinary human would expect, e.g.
  897 .Qq 2.jpg
  898 comes before
  899 .Qq 10.jpg .
  900 Note that this option only has an effect when a sort mode is set using
  901 .Cm --sort .
  902 .
  903 .It Cm --xinerama-index Ar screen
  904 .
  905 .Pq optional feature, $MAN_XINERAMA$ in this build
  906 Override
  907 .Nm Ns No 's
  908 idea of the active Xinerama screen.
  909 May be useful in certain circumstances where the window manager places the feh
  910 window on Xinerama screen A while
  911 .Nm
  912 assumes that it will be placed on screen B.
  913 .
  914 .Pp
  915 .
  916 In background setting mode: When used with any option other than
  917 .Cm --bg-tile :
  918 Only set wallpaper on
  919 .Ar screen .
  920 All other screens will be filled black/white.
  921 .
  922 This is most useful in a Xinerama configuration with overlapping screens.
  923 For instance, assume you have two overlapping displays (index 0 and 1),
  924 where index 0 is smaller.
  925 To center a background on the display with index 0 and fill the extra space
  926 on index 1 black/white, use
  927 .Qq --xinerama-index 0
  928 when setting the wallpaper.
  929 .
  930 .It Cm --zoom Ar percent | Cm max | Cm fill
  931 .
  932 Zoom images by
  933 .Ar percent
  934 when in full screen mode or when window geometry is fixed.
  935 When combined with
  936 .Cm --auto-zoom ,
  937 zooming will be limited to the specified
  938 .Ar percent .
  939 Specifying
  940 .Cm max
  941 is like setting
  942 .Cm --auto-zoom ,
  943 using
  944 .Cm fill
  945 makes
  946 .Nm
  947 zoom the image like the
  948 .Cm --bg-fill
  949 mode.
  950 .
  951 .El
  952 .
  953 .
  954 .Sh MONTAGE MODE OPTIONS
  955 .
  956 These additional options can be used for index, montage and
  957 .Pq partially
  958 thumbnail mode.
  959 .
  960 .Bl -tag -width indent
  961 .
  962 .It Cm -a , --alpha Ar int
  963 .
  964 When drawing thumbnails onto the background, set their transparency level to
  965 .Ar int
  966 .Pq 0 - 255 .
  967 .
  968 .It Cm -b , --bg Ar file | Cm trans
  969 .
  970 Use
  971 .Ar file
  972 as background for your montage.
  973 With this option specified, the montage size will default to the size of
  974 .Ar file
  975 if no size restrictions were specified.
  976 Alternatively, if
  977 .Ar file
  978 is
  979 .Qq trans ,
  980 the background will be made transparent.
  981 .
  982 .It Cm -X , --ignore-aspect
  983 .
  984 By default, the montage thumbnails will retain their aspect ratios, while
  985 fitting into thumb-width/-height.
  986 This options forces them to be the size set by
  987 .Cm --thumb-width No and Cm --thumb-height .
  988 This will prevent any empty space in the final montage.
  989 .
  990 .It Cm -H , --limit-height Ar pixels
  991 .
  992 Limit the height of the montage.
  993 .
  994 .It Cm -W , --limit-width Ar pixels
  995 .
  996 Limit the width of the montage, defaults to 800 pixels.
  997 .
  998 .Pp
  999 .
 1000 If both
 1001 .Cm --limit-width No and Cm --limit-height
 1002 are specified, the montage will be exactly
 1003 .Ar width No x Ar height
 1004 pixels in dimensions.
 1005 .
 1006 .It Cm -o , --output Ar file
 1007 .
 1008 Save the created montage to
 1009 .Ar file .
 1010 .
 1011 .It Cm -O , --output-only Ar file
 1012 .
 1013 Just save the created montage to
 1014 .Ar file
 1015 without displaying it.
 1016 .
 1017 .It Cm -s , --stretch
 1018 .
 1019 Normally, if an image is smaller than the specified thumbnail size, it will
 1020 not be enlarged.
 1021 If this option is set, the image will be scaled up to fit the thumbnail size.
 1022 Aspect ratio will be maintained unless
 1023 .Cm --ignore-aspect
 1024 is specified.
 1025 .
 1026 .It Cm -E , --thumb-height Ar pixels
 1027 .
 1028 Set thumbnail height.
 1029 .
 1030 .It Cm -y , --thumb-width Ar pixels
 1031 .
 1032 Set thumbnail width.
 1033 .
 1034 .El
 1035 .
 1036 .
 1037 .Sh INDEX AND THUMBNAIL MODE OPTIONS
 1038 .
 1039 In addition to
 1040 .Sx MONTAGE MODE OPTIONS
 1041 .Cm --alpha , --bg , --limit-height , --limit-width , --output , --output-only ,
 1042 .Cm --thumb-height , --thumb-width ,
 1043 the following options can be used.
 1044 .
 1045 .Bl -tag -width indent
 1046 .
 1047 .It Cm --index-info Ar format
 1048 .
 1049 Show image information based on
 1050 .Ar format
 1051 below thumbnails in index / thumbnail mode.
 1052 See
 1053 .Sx FORMAT SPECIFIERS .
 1054 May contain newlines.
 1055 .
 1056 Use
 1057 .Qq --index-info ''
 1058 to display thumbnails without any info text
 1059 .
 1060 .Pp
 1061 .
 1062 Note: If you specify image-related formats
 1063 .Pq such as \&%w or \&%s ,
 1064 .Nm
 1065 needs to load all images to calculate the dimensions of its own window.
 1066 So when using them with many files, it will take a while before a
 1067 .Nm
 1068 window becomes visible.
 1069 Use
 1070 .Cm --preload
 1071 to get a progress bar.
 1072 .
 1073 .It Cm -@ , --title-font Ar font
 1074 .
 1075 Set font to print a title on the index, if no font is specified, no title will
 1076 be printed.
 1077 .
 1078 .It Cm -J , --thumb-redraw Ar n
 1079 .
 1080 Redraw thumbnail window every
 1081 .Ar n
 1082 images while generating thumbnails.
 1083 Redrawing takes quite long, so the default is 10.
 1084 Set
 1085 .Ar n No = 1
 1086 to update the thumbnail window immediately.
 1087 With
 1088 .Ar n No = 0 ,
 1089 there will only be one redraw once all thumbnails are loaded.
 1090 .
 1091 .El
 1092 .
 1093 .
 1094 .Sh BACKGROUND SETTING
 1095 .
 1096 In many desktop environments,
 1097 .Nm
 1098 can also be used as a background setter.
 1099 Unless you pass the
 1100 .Cm --no-fehbg
 1101 option, it will write a script to set the current background to
 1102 .Pa ~/.fehbg .
 1103 So to have your background restored every time you start X, you can add
 1104 .Qq ~/.fehbg &
 1105 to your X startup script
 1106 .Pq such as Pa ~/.xinitrc .
 1107 Note that the commandline written to
 1108 .Pa ~/.fehbg
 1109 always includes the
 1110 .Cm --no-fehbg
 1111 option to ensure that it is not inadvertently changed by differences in
 1112 X11 screen layout or similar.
 1113 .
 1114 .Pp
 1115 .
 1116 Note that
 1117 .Nm
 1118 does not support setting the wallpaper of GNOME shell desktops.
 1119 In this environment, you can use
 1120 .Qq gsettings set org.gnome.desktop.background picture-uri file:/// Ns Ar path
 1121 instead.
 1122 .
 1123 .Pp
 1124 .
 1125 For
 1126 .Cm --bg-center , --bg-fill ,
 1127 and
 1128 .Cm --bg-max ,
 1129 you can use
 1130 .Cm --geometry
 1131 to specify an offset from one side of the screen instead of centering the image.
 1132 Positive values will offset from the left/top side, negative values from the
 1133 bottom/right.
 1134 +0 and -0 are both valid and distinct values.
 1135 .
 1136 .Pp
 1137 .
 1138 Note that all options except
 1139 .Cm --bg-tile
 1140 support Xinerama.
 1141 For instance, if you have multiple screens connected and use e.g.
 1142 .Cm --bg-center ,
 1143 .Nm
 1144 will center or appropriately offset the image on each screen.
 1145 You may even specify more than one file, in that case, the first file is set
 1146 on screen 0, the second on screen 1, and so on.
 1147 .
 1148 .Pp
 1149 .
 1150 Use
 1151 .Cm --no-xinerama
 1152 to treat the whole X display as one screen when setting wallpapers.
 1153 You may also use
 1154 .Cm --xinerama-index
 1155 to use
 1156 .Nm
 1157 as a background setter for a specific screen.
 1158 .
 1159 .Bl -tag -width indent
 1160 .
 1161 .It Cm --bg-center
 1162 .
 1163 Center the file on the background.
 1164 If it is too small, it will be surrounded by a border as specified by
 1165 .Cm --image-bg .
 1166 .
 1167 .It Cm --bg-fill
 1168 .
 1169 Like
 1170 .Cm --bg-scale ,
 1171 but preserves aspect ratio by zooming the image until it fits.
 1172 Either a horizontal or a vertical part of the image will be cut off
 1173 .
 1174 .It Cm --bg-max
 1175 .
 1176 Like
 1177 .Cm --bg-fill ,
 1178 but scale the image to the maximum size that fits the screen with borders on one side.
 1179 The border color can be set using
 1180 .Cm --image-bg .
 1181 .
 1182 .It Cm --bg-scale
 1183 .
 1184 Fit the file into the background without repeating it, cutting off stuff or
 1185 using borders.
 1186 But the aspect ratio is not preserved either
 1187 .
 1188 .It Cm --bg-tile
 1189 .
 1190 Tile
 1191 .Pq repeat
 1192 the image in case it is too small for the screen
 1193 .
 1194 .It Cm --no-fehbg
 1195 .
 1196 Do not write a
 1197 .Pa ~/.fehbg
 1198 file
 1199 .
 1200 .El
 1201 .
 1202 .
 1203 .Sh FORMAT SPECIFIERS
 1204 .
 1205 .Bl -tag -width indent
 1206 .
 1207 .It %f
 1208 .
 1209 Image path/filename
 1210 .
 1211 .It %F
 1212 .
 1213 Escaped image path/filename
 1214 .Pq for use in shell commands
 1215 .
 1216 .It %g
 1217 .
 1218 w,h window dimensions in pixels (mnemonic: geometry)
 1219 .
 1220 .It %h
 1221 .
 1222 Image height
 1223 .
 1224 .It %l
 1225 .
 1226 Total number of files in filelist
 1227 .
 1228 .It %L
 1229 .
 1230 Temporary copy of filelist.
 1231 Multiple uses of %L within the same format string will return the same copy.
 1232 .
 1233 .It %m
 1234 .
 1235 Current mode
 1236 .
 1237 .It %n
 1238 .
 1239 Image name
 1240 .
 1241 .It \&%N
 1242 .
 1243 Escaped image name
 1244 .
 1245 .It %o
 1246 .
 1247 x,y offset of top-left image corner to window corner in pixels
 1248 .
 1249 .It %p
 1250 .
 1251 Number of image pixels
 1252 .
 1253 .It \&%P
 1254 .
 1255 Number of image pixels in human-readable format with k/M
 1256 .Pq kilopixels / megapixels
 1257 suffix
 1258 .
 1259 .It %r
 1260 .
 1261 Image rotation.
 1262 A half right turn equals pi.
 1263 .
 1264 .It %s
 1265 .
 1266 Image size in bytes
 1267 .
 1268 .It %S
 1269 .
 1270 Human-readable image size
 1271 .Pq kB / MB
 1272 .
 1273 .It %t
 1274 .
 1275 Image format
 1276 .
 1277 .It %u
 1278 .
 1279 Number of current file
 1280 .
 1281 .It %w
 1282 .
 1283 Image width
 1284 .
 1285 .It %v
 1286 .
 1287 .Nm
 1288 version
 1289 .
 1290 .It \&%V
 1291 .
 1292 Process ID
 1293 .
 1294 .It %z
 1295 .
 1296 Current image zoom, rounded to two decimal places
 1297 .
 1298 .It %Z
 1299 .
 1300 Current image zoom, higher precision
 1301 .
 1302 .It %%
 1303 .
 1304 A literal %
 1305 .
 1306 .El
 1307 .
 1308 .
 1309 .Sh CONFIGURATION
 1310 .
 1311 .Nm
 1312 has three config files:
 1313 .Pa themes
 1314 for theme definitions,
 1315 .Pa keys
 1316 for key bindings and
 1317 .Pa buttons
 1318 for mouse button bindings.
 1319 It will try to read them from
 1320 .Pa $XDG_CONFIG_HOME/feh/ ,
 1321 which
 1322 .Pq when XDG_CONFIG_HOME is unset
 1323 defaults to
 1324 .Pa ~/.config/feh/ .
 1325 If the files are not found in that directory, it will also try
 1326 .Pa /etc/feh/ .
 1327 .Pp
 1328 All config files treat lines starting with a
 1329 .Qq #
 1330 character as comments.
 1331 Comments at the end of a line are not supported.
 1332 .
 1333 .
 1334 .Sh THEMES CONFIG SYNTAX
 1335 .
 1336 .Pa .config/feh/themes
 1337 allows the naming of option groups, called themes.
 1338 .
 1339 .Pp
 1340 .
 1341 It takes entries of the form
 1342 .Qq Ar theme options ... ,
 1343 where
 1344 .Ar theme
 1345 is the name of the entry and
 1346 .Ar options
 1347 are the options which will be applied when the theme is used.
 1348 .
 1349 .Pp
 1350 .
 1351 Note that the option parser does not behave like a normal shell: filename
 1352 expansion and backslash escape sequences are not supported and passed to
 1353 feh's option parser as-is.
 1354 However, quoting of arguments is respected and can be used for arguments
 1355 with whitespace.
 1356 .
 1357 So, the sequence
 1358 .Qq --info Qq foo bar
 1359 works as intended
 1360 .Pq that is, it display the string Qq foo bar ,
 1361 whereas the option string
 1362 .Qq --info foo\e bar
 1363 will only display
 1364 .Qq foo\e
 1365 and complain about the file bar not existing.
 1366 Please keep this in mind when writing theme files.
 1367 .
 1368 .Pp
 1369 .
 1370 An example entry is
 1371 .Qq imagemap -rVq --thumb-width 40 --thumb-height 30 --index-info \&'%n\en\&%wx\&%h\&' .
 1372 .
 1373 .Pp
 1374 .
 1375 You can use this theme in two ways.
 1376 Either call
 1377 .Qo
 1378 .Nm
 1379 -Timagemap *.jpg
 1380 .Qc ,
 1381 or create a symbolic link to
 1382 .Nm
 1383 with the name of the theme you want it to use.
 1384 For the example above, this would be
 1385 .Qo
 1386 ln -s `which
 1387 .Nm
 1388 ` ~/bin/imagemap
 1389 .Qc .
 1390 Now just run
 1391 .Qq imagemap *.jpg
 1392 to use these options.
 1393 .
 1394 .Pp
 1395 .
 1396 Note that you can split a theme over several lines by placing a backslash at
 1397 the end of an unfinished line.
 1398 A single option-argument-pair must not span multiple lines.
 1399 A single line must not be longer than 1023 characters, but there's no upper
 1400 limit for the length of a theme.
 1401 .
 1402 .Pp
 1403 .
 1404 Command line options always override theme options.
 1405 .
 1406 .
 1407 .Sh KEYS CONFIG SYNTAX
 1408 .
 1409 .Pa .config/feh/keys
 1410 defines key bindings.
 1411 It has entries of the form
 1412 .Qq Ar action Op Ar key1 Op Ar key2 Op Ar key3 .
 1413 .
 1414 .Pp
 1415 .
 1416 Each
 1417 .Ar key
 1418 is an X11 keysym name as shown by
 1419 .Xr xev 1 ,
 1420 like
 1421 .Qq Delete .
 1422 It may optionally start with modifiers for things like Control, in which case
 1423 .Ar key
 1424 looks like
 1425 .Ar mod Ns No - Ns Ar keysym
 1426 .Po
 1427 for example
 1428 .Qq C-Delete
 1429 for Ctrl+Delete or
 1430 .Qq C-1-Delete
 1431 for Ctrl+Alt+Delete
 1432 .Pc
 1433 .
 1434 .Pp
 1435 .
 1436 Available modifiers are
 1437 .Ar C No for Control ,
 1438 .Ar S No for Shift and
 1439 .Ar 1 , 4 No for Mod1 and Mod4 .
 1440 To match an uppercase letter like
 1441 .Qq S
 1442 instead of
 1443 .Qq s ,
 1444 the Shift modifier is not required.
 1445 .
 1446 .Pp
 1447 .
 1448 Specifying an
 1449 .Ar action
 1450 without any keys unbinds it (i.e. the default bindings are removed).
 1451 .
 1452 .Pp
 1453 .
 1454 .Em Note:\&
 1455 Do not use the same keybinding for multiple actions.
 1456 When binding an action to a new key
 1457 .Pq or mouse button ,
 1458 make sure to unbind it from its previous action, if present.
 1459 .Nm
 1460 does not check for conflicting bindings, so their behaviour is undefined.
 1461 .
 1462 .Pp
 1463 .
 1464 For a list of the
 1465 .Ar action
 1466 names, see
 1467 .Sx KEYS .
 1468 Note that not all of the key names used there correspond to X11 keysyms.
 1469 Most notably, page up
 1470 .Pq Prior / Page_Up ,
 1471 page down
 1472 .Pq Next / Page_Down
 1473 and the keypad keys
 1474 .Pq KP_*
 1475 do not.
 1476 .
 1477 .
 1478 .Sh KEYS
 1479 .
 1480 The following actions and default key bindings can be used in an image window.
 1481 .Pq The strings in Bo square brackets Bc are the config action names .
 1482 .
 1483 If
 1484 .Nm
 1485 is running inside a terminal and its standard input is not used for images or
 1486 filelists, key input from the terminal is also accepted.
 1487 However, terminal input support is currently limited to most alphanumeric
 1488 characters
 1489 .Pq 0-9 a-z A-Z and some more ,
 1490 arrow keys, return and backspace.
 1491 The Alt
 1492 .Pq Mod1
 1493 modifier is also supported.
 1494 .
 1495 .Bl -tag -width indent
 1496 .
 1497 .It a Bq toggle_actions
 1498 .
 1499 Toggle actions display
 1500 .Pq see Cm --draw-actions
 1501 .
 1502 .It A Bq toggle_aliasing
 1503 .
 1504 Enable/Disable anti-aliasing
 1505 .
 1506 .It c Bq toggle_caption
 1507 .
 1508 Caption entry mode.
 1509 If
 1510 .Cm --caption-path
 1511 has been specified, then this enables caption editing.
 1512 The caption at the bottom of the screen will turn yellow and can be edited.
 1513 Hit return to confirm and save the caption, or escape to cancel editing.
 1514 Note that you can insert an actual newline into the caption using
 1515 .Aq Ctrl+return .
 1516 .
 1517 .It d Bq toggle_filenames
 1518 .
 1519 Toggle filename display
 1520 .Pq see Cm --draw-filename
 1521 .
 1522 .It e Bq toggle_exif
 1523 .
 1524 .Pq optional feature, $MAN_EXIF$ in this build
 1525 Toggle EXIF tag display
 1526 .
 1527 .It f Bq toggle_fullscreen
 1528 .
 1529 Toggle fullscreen
 1530 .
 1531 .It g Bq toggle_fixed_geometry
 1532 .
 1533 Enable/Disable automatic window resize when changing images.
 1534 .
 1535 .It h Bq toggle_pause
 1536 .
 1537 Pause/Continue the slideshow.
 1538 When it is paused, it will not automatically change slides based on
 1539 .Cm --slideshow-delay .
 1540 .
 1541 .It i Bq toggle_info
 1542 .
 1543 Toggle info display
 1544 .Pq see Cm --info
 1545 .
 1546 .It k Bq toggle_keep_vp
 1547 .
 1548 Toggle zoom and viewport keeping.
 1549 When enabled,
 1550 .Nm
 1551 will keep zoom and X, Y offset when switching images.
 1552 .
 1553 .It L Bq save_filelist
 1554 .
 1555 Save the current filelist as
 1556 .Qq feh_PID_ID_filelist
 1557 .
 1558 .It m Bq toggle_menu
 1559 .
 1560 Show menu.
 1561 Use the arrow keys and return to select items, and
 1562 .Aq escape
 1563 to close the menu.
 1564 .
 1565 .It n , Ao space Ac , Ao Right Ac Bq next_img
 1566 .
 1567 Show next image.
 1568 Selects the next image in thumbnail mode.
 1569 .
 1570 .It o Bq toggle_pointer
 1571 .
 1572 Toggle pointer visibility
 1573 .
 1574 .It p , Ao BackSpace Ac , Ao Left Ac Bq prev_img
 1575 .
 1576 Show previous image.
 1577 Selects the previous image in thumbnail mode.
 1578 .
 1579 .It q , Ao Escape Ac Bq quit
 1580 .
 1581 Quit
 1582 .Nm
 1583 .
 1584 .It r Bq reload_image
 1585 .
 1586 Reload current image.
 1587 Useful for webcams
 1588 .
 1589 .It s Bq save_image
 1590 .
 1591 Save the current image as
 1592 .Qq feh_PID_ID_FILENAME
 1593 .
 1594 .It w Bq size_to_image
 1595 .
 1596 Change window size to fit current image size
 1597 .Pq plus/minus zoom, if set .
 1598 In scale-down and fixed-geometry mode, this also updates the window size limits.
 1599 .
 1600 .It x Bq close
 1601 .
 1602 Close current window
 1603 .
 1604 .It z Bq jump_random
 1605 .
 1606 Jump to a random position in the current filelist
 1607 .
 1608 .It Z Bq toggle_auto_zoom
 1609 .
 1610 Toggle auto-zoom.
 1611 .
 1612 .It \&[, \&] Bq prev_dir, next_dir
 1613 .
 1614 Jump to the first image of the previous or next sequence of images sharing
 1615 a directory name in the current filelist.
 1616 Use --sort dirname if you would like to ensure that all images in a directory
 1617 are grouped together.
 1618 .
 1619 .It < , > Bq orient_3 , orient_1
 1620 .
 1621 rotate the image 90 degrees (counter)clockwise.
 1622 .
 1623 .Pp
 1624 .
 1625 When
 1626 .Cm --edit
 1627 is used, this also rotates the image in the underlying file.
 1628 Rotation is lossless, but may create artifacts in some image corners when
 1629 used with JPEG images.
 1630 Rotating in the reverse direction will make them go away.
 1631 See
 1632 .Xr jpegtran 1
 1633 for more about lossless JPEG rotation.
 1634 .
 1635 .Em Note:\&
 1636 .Nm
 1637 assumes that this feature is used to normalize image orientation.
 1638 For JPEG images, it will unconditionally set the EXIF orientation
 1639 tag to 1
 1640 .Pq Qq 0,0 is top left
 1641 after every rotation.
 1642 See
 1643 .Xr jpegexiforient 1
 1644 for details on how to change this flag.
 1645 .
 1646 .It _ Bq flip
 1647 .
 1648 Vertically flip image.
 1649 When
 1650 .Cm --edit
 1651 is used, this also flips the image in the underlying file
 1652 .Pq see above .
 1653 .
 1654 .It | Bq mirror
 1655 .
 1656 Horizontally flip image.
 1657 When
 1658 .Cm --edit
 1659 is used, this also flips the image in the underlying file
 1660 .Pq see above .
 1661 .
 1662 .It 0 .. 9 Bq action_0 .. action_9
 1663 .
 1664 Execute the corresponding action
 1665 .Pq 0 = Cm --action , No 1 = Cm --action1 No etc.
 1666 .
 1667 .It Ao Return Ac Bq action_0
 1668 .
 1669 Run the command defined by
 1670 .Cm --action
 1671 .
 1672 .It Ao Home Ac Bq jump_first
 1673 .
 1674 Show first image
 1675 .
 1676 .It Ao End Ac Bq jump_last
 1677 .
 1678 Show last image
 1679 .
 1680 .It Ao page up Ac Bq jump_fwd
 1681 .
 1682 Go forward ~5% of the filelist
 1683 .
 1684 .It Ao page down Ac Bq jump_back
 1685 .
 1686 Go backward ~5% of the filelist
 1687 .
 1688 .It + Bq reload_plus
 1689 .
 1690 Increase reload delay by 1 second
 1691 .
 1692 .It - Bq reload_minus
 1693 .
 1694 Decrease reload delay by 1 second
 1695 .
 1696 .It Ao Delete Ac Bq remove
 1697 .
 1698 Remove current file from filelist
 1699 .
 1700 .It Ao Ctrl+Delete Ac Bq delete
 1701 .
 1702 Remove current file from filelist and delete it
 1703 .
 1704 .It Ao keypad Left Ac , Ao Ctrl+Left Ac Bq scroll_left
 1705 .
 1706 Scroll to the left
 1707 .
 1708 .It Ao keypad Right Ac , Ao Ctrl+Right Ac Bq scroll_right
 1709 .
 1710 Scroll to the right
 1711 .
 1712 .It Ao keypad up Ac , Ao Ctrl+Up Ac Bq scroll_up
 1713 .
 1714 Scroll up
 1715 .
 1716 .It Ao keypad Down Ac , Ao Ctrl+Down Ac Bq scroll_down
 1717 .
 1718 Scroll down.
 1719 Note that the scroll keys work without anti-aliasing for performance reasons;
 1720 hit the render key after scrolling to anti-alias the image.
 1721 .
 1722 .It Aq Alt+Left Bq scroll_left_page
 1723 .
 1724 Scroll to the left by one page
 1725 .
 1726 .It Aq Alt+Right Bq scroll_right_page
 1727 .
 1728 Scroll to the right by one page
 1729 .
 1730 .It Aq Alt+Up Bq scroll_up_page
 1731 .
 1732 Scroll up by one page
 1733 .
 1734 .It Aq Alt+Down Bq scroll_down_page
 1735 .
 1736 Scroll down by one page
 1737 .
 1738 .It R, Ao keypad begin Ac Bq render
 1739 .
 1740 Anti-alias the image.
 1741 Opens the currently selected image in thumbnail mode.
 1742 .
 1743 .It Ao keypad + Ac , Ao Up Ac Bq zoom_in
 1744 .
 1745 Zoom in
 1746 .
 1747 .It Ao keypad - Ac , Ao Down Ac Bq zoom_out
 1748 .
 1749 Zoom out
 1750 .
 1751 .It *, Ao keypad * Ac Bq zoom_default
 1752 .
 1753 Zoom to 100%
 1754 .
 1755 .It /, Ao keypad / Ac Bq zoom_fit
 1756 .
 1757 Zoom to fit the window size
 1758 .
 1759 .It ! Bq zoom_fill
 1760 .
 1761 Zoom to fill the window size like
 1762 .Cm --bg-fill
 1763 .
 1764 .El
 1765 .
 1766 .Ss MENU KEYS
 1767 .
 1768 The following keys bindings are used for the
 1769 .Nm
 1770 menu:
 1771 .
 1772 .Bl -tag -width indent
 1773 .
 1774 .It Ao Escape Ac Bq menu_close
 1775 .
 1776 Close the menu
 1777 .
 1778 .It Ao Up Ac Bq menu_up
 1779 .
 1780 Highlight previous menu item
 1781 .
 1782 .It Ao Down Ac Bq menu_down
 1783 .
 1784 Highlight next menu item
 1785 .
 1786 .It Ao Left Ac Bq menu_parent
 1787 .
 1788 Highlight parent menu item
 1789 .
 1790 .It Ao Right Ac Bq menu_child
 1791 .
 1792 Highlight child menu item
 1793 .
 1794 .It Ao Return Ac , Ao space Ac Bq menu_select
 1795 .
 1796 Select highlighted menu item
 1797 .
 1798 .El
 1799 .
 1800 .
 1801 .Sh BUTTONS CONFIG SYNTAX
 1802 .
 1803 .Pa .config/feh/buttons .
 1804 This works like the keys config file: the entries are of the form
 1805 .Qq Ar action Op Ar binding .
 1806 .
 1807 .Pp
 1808 .
 1809 Each
 1810 .Ar binding
 1811 is a button number.
 1812 It may optionally start with modifiers for things like Control, in which case
 1813 .Ar binding
 1814 looks like
 1815 .Ar mod Ns No - Ns Ar button
 1816 .Pq for example "C-1" for Ctrl + Left button .
 1817 .
 1818 .Pp
 1819 .
 1820 .Em Note:\&
 1821 Do not use the same button for multiple actions.
 1822 .Nm
 1823 does not check for conflicting bindings, so their behaviour is undefined.
 1824 .
 1825 Either unbind the unwanted action, or bind it to another unused button.
 1826 .
 1827 The order in which you bind / unbind does not matter, though.
 1828 .
 1829 .Pp
 1830 .
 1831 For the available modifiers, see
 1832 .Sx KEYS CONFIGURATION SYNTAX .
 1833 .
 1834 .
 1835 .Ss BUTTONS
 1836 .
 1837 In an image window, the following buttons may be used
 1838 .Pq The strings in Bo square brackets Bc are the config action names .
 1839 Additionally, all actions specified in the
 1840 .Sx KEYS
 1841 section can also be bound to a button.
 1842 .
 1843 .Bl -tag -width indent
 1844 .
 1845 .It unbound Bq reload
 1846 .
 1847 Reload current image
 1848 .
 1849 .It 1 Ao left mouse button Ac Bq pan
 1850 .
 1851 pan the current image
 1852 .
 1853 .It 2 Ao middle mouse button Ac Bq zoom
 1854 .
 1855 Zoom the current image
 1856 .
 1857 .It 3 Ao right mouse button Ac Bq toggle_menu
 1858 .
 1859 Toggle menu
 1860 .
 1861 .It 4 Ao mousewheel down Ac Bq prev_img
 1862 .
 1863 Show previous image
 1864 .
 1865 .It 5 Ao mousewheel up Ac Bq next_img
 1866 .
 1867 Show next image
 1868 .
 1869 .It Ctrl+1 Bq blur
 1870 .
 1871 Blur current image
 1872 .
 1873 .It Ctrl+2 Bq rotate
 1874 .
 1875 Rotate current image
 1876 .
 1877 .It unbound Bq zoom_in
 1878 .
 1879 Zoom in
 1880 .
 1881 .It unbound Bq zoom_out
 1882 .
 1883 Zoom out
 1884 .
 1885 .
 1886 .El
 1887 .
 1888 .
 1889 .Sh MOUSE ACTIONS
 1890 .
 1891 Default Bindings:
 1892 When viewing an image, mouse button 1 pans the image
 1893 .Pq moves it around
 1894 or, when only clicked, moves to the next image
 1895 .Pq slideshow mode only .
 1896 Quick drags with less than 2px of movement per axis will be treated as clicks
 1897 to aid graphics tablet users.
 1898 .
 1899 Mouse button 2 zooms
 1900 .Po click and drag left->right to zoom in, right->left to zoom out, click once
 1901 to restore zoom to 100%
 1902 .Pc
 1903 and mouse button 3 opens the menu.
 1904 .
 1905 .Pp
 1906 .
 1907 Ctrl+Button 1 blurs or sharpens the image
 1908 .Pq drag left to blur, right to sharpen ;
 1909 Ctrl+Button 2 rotates the image around the center point.
 1910 .
 1911 .Pp
 1912 .
 1913 A note about pan and zoom modes:
 1914 In pan mode, if you reach a window border but haven't yet panned to the end of
 1915 the image,
 1916 .Nm
 1917 will warp your cursor to the opposite border so you can continue panning.
 1918 .
 1919 .Pp
 1920 .
 1921 When clicking the zoom button and immediately releasing it, the image will be
 1922 back at 100% zoom.
 1923 When clicking it and moving the mouse while holding the button down, the zoom
 1924 will be continued at the previous zoom level.
 1925 The zoom will always happen so that the pixel on which you entered the zoom mode
 1926 remains stationary.
 1927 So, to enlarge a specific part of an image, click the zoom button on that part.
 1928 .
 1929 .
 1930 .Sh SIGNALS
 1931 .
 1932 In slideshow and multiwindow mode,
 1933 .Nm
 1934 handles the following signals:
 1935 .
 1936 .Bl -tag -width indent
 1937 .
 1938 .It Dv SIGUSR1
 1939 .
 1940 Slideshow mode: switch to next image;
 1941 reload current image if the slideshow consists of a single file.
 1942 Multiwindow mode: reload all images.
 1943 .
 1944 .It Dv SIGUSR2
 1945 .
 1946 Slideshow mode: switch to previous image;
 1947 reload current image if the slideshow consists of a single file.
 1948 Multiwindow mode: reload all images.
 1949 .
 1950 .El
 1951 .
 1952 .
 1953 .Sh USAGE EXAMPLES
 1954 .
 1955 Here are some examples of useful option combinations.
 1956 See also:
 1957 .Aq https://feh.finalrewind.org/examples/
 1958 .
 1959 .Bl -tag -width indent
 1960 .
 1961 .It feh ~/Pictures
 1962 .
 1963 Show all images in ~/Pictures
 1964 .
 1965 .It feh -r ~/Pictures
 1966 .
 1967 Recursively show all images found in ~/Pictures and subdirectories
 1968 .
 1969 .It feh -rSfilename --version-sort ~/Pictures
 1970 .
 1971 Same as above, but sort naturally.
 1972 By default, feh will show files in the string order of their names, meaning e.g.
 1973 .Qq foo 10.jpg
 1974 will come before
 1975 .Qq foo 2.jpg .
 1976 In this case, they are instead ordered as a human would expect.
 1977 .
 1978 .It feh -t -Sfilename -E 128 -y 128 -W 1024 ~/Pictures
 1979 .
 1980 Show 128x128 pixel thumbnails, limit window width to 1024 pixels.
 1981 .
 1982 .It feh -t -Sfilename -E 128 -y 128 -W 1024 -P -C /usr/share/fonts/truetype/ttf-dejavu/ -e DejaVuSans/8 ~/Pictures
 1983 .
 1984 Same as above, but enable thumbnail caching and use a smaller font.
 1985 .
 1986 .It feh -irFarial/14 -O index.jpg ~/Pictures
 1987 .
 1988 Make an index print of ~/Pictures and all directories below it, using 14 point
 1989 Arial to write the image info under each thumbnail.
 1990 Save the image as index.jpg and don't display it, just exit.
 1991 Note that this even works without a running X server
 1992 .
 1993 .It feh --unloadable -r ~/Pictures
 1994 .
 1995 Print all unloadable images in ~/Pictures, recursively
 1996 .
 1997 .It feh -f by_width -S width --reverse --list \&.
 1998 .
 1999 Write a list of all images in the directory to by_width, sorted by width
 2000 .Pq widest images first
 2001 .
 2002 .It feh -w ~/Pictures/holidays
 2003 .
 2004 Open each image in ~/Pictures/holidays in its own window
 2005 .
 2006 .It feh -FD5 -Sname ~/Pictures/presentation
 2007 .
 2008 Show the images in .../presentation, sorted by name, in fullscreen,
 2009 automatically change to the next image after 5 seconds
 2010 .
 2011 .It feh -rSwidth -A Qo mv %F ~/images/\&%N Qc ~/Pictures
 2012 .
 2013 View all images in ~/Pictures and below, sorted by width, move an image to
 2014 ~/image/image_name when enter is pressed
 2015 .
 2016 .It feh --start-at ~/Pictures/foo.jpg
 2017 .
 2018 View all images in ~/Pictures, starting with foo.jpg.
 2019 All other images are still in the slideshow and can be viewed normally
 2020 .
 2021 .It feh --start-at ~/Pictures/foo.jpg ~/Pictures
 2022 .
 2023 Same as above.
 2024 .
 2025 .It feh --info \&"exifgrep '\&(Model\&|DateTimeOriginal\&|FNumber\&|ISO\&|Flash\&)' %F \&| cut -d \&. -f 4-\&" \&.
 2026 .
 2027 Show some EXIF information, extracted by exifprobe/exifgrep
 2028 .
 2029 .It feh --action 'rm %F' -rl --max-dimension 1000x800
 2030 .
 2031 Recursively remove all images with dimensions below or equal to 1000x800 pixels
 2032 from the current directory.
 2033 .
 2034 .It feh -L '%w %h %f' \&| awk '{ if \&($1 > $2\&) { print $0 } }' \&| cut -d ' ' -f 3- \&| feh -f -
 2035 .
 2036 Show landscape pictures
 2037 .Pq image width greater than height
 2038 in the current directory.
 2039 .
 2040 .El
 2041 .
 2042 .
 2043 .Sh DEPENDENCIES
 2044 .
 2045 When
 2046 .Cm --edit
 2047 is used,
 2048 .Nm
 2049 needs the
 2050 .Cm jpegtran
 2051 and
 2052 .Cm jpegexiforient
 2053 binaries
 2054 .Pq usually distributed in Qo libjpeg-progs Qc or similar
 2055 for lossless JPEG rotation.
 2056 .
 2057 .Pp
 2058 .
 2059 To view images from URLs such as "http://",
 2060 .Nm
 2061 must be compiled with libcurl support.
 2062 It is $MAN_CURL$ in this build
 2063 .
 2064 .
 2065 .Sh KNOWN BUGS
 2066 .
 2067 On systems with giflib 5.1.2,
 2068 .Nm
 2069 may be unable to load gif images.
 2070 For affected mips, mipsel and arm devices, gif support is completely
 2071 broken, while on x86 / x86_64 gifs can usually only be loaded if they are
 2072 the first image in the filelist.
 2073 This appears to be a bug in giflib,
 2074 see
 2075 .Aq https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=813729
 2076 for details.
 2077 Workaround: Use
 2078 .Cm --conversion-timeout 5
 2079 .Pq or some other positive value
 2080 to load gifs with imagemagick instead, or downgrade to giflib 5.1.1, or
 2081 upgrade to giflib 5.1.4.
 2082 .
 2083 .Pp
 2084 .
 2085 While loading images using libcurl,
 2086 .Nm
 2087 will not react to key or mouse actions.
 2088 .
 2089 .Pp
 2090 .
 2091 Thumbnail mode is somewhat inefficient, and because of that not nearly as fast
 2092 as it could be.
 2093 .
 2094 .Pp
 2095 .
 2096 .Cm --scale-down
 2097 does not take window decorations into account and may therefore make the
 2098 window slightly too large.
 2099 .
 2100 .Ss REPORTING BUGS
 2101 .
 2102 If you find a bug, please report it to
 2103 .Aq derf+feh@finalrewind.org
 2104 or via
 2105 .Aq https://github.com/derf/feh/issues .
 2106 You are also welcome to direct any feh-related comments/questions/... to #feh
 2107 on irc.oftc.net.
 2108 .
 2109 .Pp
 2110 .
 2111 Please include the feh version
 2112 .Aq the output of Qq feh --version ,
 2113 steps to reproduce the bug and, if necessary, images to reproduce it.
 2114 .
 2115 .
 2116 .Sh FUTURE PLANS
 2117 .
 2118 Plans for the following releases:
 2119 .
 2120 .Bl -bullet -compact
 2121 .
 2122 .It
 2123 Make zoom options more intuitive
 2124 .
 2125 .El
 2126 .
 2127 .
 2128 .Sh LICENSE
 2129 .
 2130 Copyright (C) 1999, 2000 by Paul Duncan.
 2131 Copyright (C) 1999, 2000 by Tom Gilbert (and various contributors).
 2132 Copyright (C) 2010-2020 by Daniel Friesel (and even more contributors).
 2133 .
 2134 .Pp
 2135 .
 2136 Permission is hereby granted, free of charge, to any person obtaining a copy
 2137 of this software and associated documentation files (the "Software"), to
 2138 deal in the Software without restriction, including without limitation the
 2139 rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 2140 sell copies of the Software, and to permit persons to whom the Software is
 2141 furnished to do so, subject to the following conditions:
 2142 .
 2143 .Pp
 2144 .
 2145 The above copyright notice and this permission notice shall be included in
 2146 all copies of the Software and its documentation and acknowledgment shall be
 2147 given in the documentation and software packages that this Software was
 2148 used.
 2149 .
 2150 .Pp
 2151 .
 2152 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 2153 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 2154 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 2155 IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 2156 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 2157 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 2158 SOFTWARE.
 2159 .
 2160 .Pp
 2161 .
 2162 Current developer: Daniel Friesel
 2163 .Aq derf@finalrewind.org
 2164 .
 2165 .Pp
 2166 .
 2167 Original author
 2168 .Pq no longer developing :
 2169 Tom Gilbert
 2170 .Aq feh_sucks@linuxbrit.co.uk
 2171 .
 2172 .Pp
 2173 .
 2174 See also:
 2175 https://feh.finalrewind.org