OS Manuals

/usr/bin/feh

Fast, lightweight image viewer which uses imlib2

From feh 3.13.1-r0 (os), captured 2026-11-05 by running feh --help (exit 0) · terse output. permalink

See 'man feh'
Options (83)
OptionDescriptionSource
-A, --action flag][[title]]actionSpecify a shell command as an action to perform on the image.man
--action1 ..Extra actions which can be set and triggered using the appropriate number key.man
--auto-reload(optional feature, disabled in this build) automatically reload image when the underlying file changes.man
--auto-rotate(optional feature, not available in this build) (deprecated in favor of Imlib2's auto-orientation support) Automatically rotate images based on EXIF data.man
-Z, --auto-zoomZoom pictures to screen size in fullscreen / fixed geometry mode.man
-x, --borderlessCreate borderless windows.man
--cache-size sizeSet imlib2 in-memory cache to size MiB.man
-P, --cache-thumbnailsEnable thumbnail caching.man
-K, --caption-path pathPath to directory containing image captions.man
--conversion-timeout timeoutfeh can use ImageMagick to try converting unloadable files into a supported file format.man
--class classSet the X11 class hint to class.man
-L, --customlist formatDon't display images, print image info according to format instead.man
-G, --draw-actionsDraw the defined actions and what they do at the top-left of the image.man
--draw-exif(optional feature, not available in this build) display some EXIF information in the bottom left corner, similar to using --info with exiv2 / exifgrep.man
-d, --draw-filenameDraw the file name at the top-left of the image.man
--draw-tintedShow overlay texts (as created by --draw-filename et al) on a semi-transparent background to improve their readability.man
--editEnable basic editing of files.man
-f, --filelist fileThis option is similar to the playlists used by music software.man
-e, --font fontSet global font.man
-C, --fontpath pathSpecify path as extra directory in which to search for fonts;man
--tap-zonesEnable tap zones for previous/next file in slide show modeman
--force-aliasingDisable anti-aliasing for zooming, background setting etc.man
-I, --fullindexSame as index mode, but with additional information below the thumbnails.man
-F, --fullscreenMake the window fullscreen.man
-g, --geometry widthUse a fixed window size as specified in the X-style geometry string, e.g. 640x480.man
-Y, --hide-pointerHide the pointer (useful for slideshows).man
-B, --image-bg styleUse style as background for transparent image parts and the like.man
-i, --indexEnable Index mode.man
--info flag]command_lineExecute command_line and display its output in the bottom left corner of the image.man
--insecureWhen viewing files with HTTPS, this option disables all certificate checks.man
-k, --keep-httpWhen viewing files using HTTP, feh normally deletes the local copies after viewing, or, if caching, on exit.man
--keep-zoom-vpWhen switching images, keep zoom and viewport settings (zoom level and X, Y offsets)man
-l, --listDon't display images.man
-U, --loadableDon't display images.man
--max-dimension widthOnly show images with width <= width and height <= height.man
-M, --menu-font fontUse font (truetype, with size, like "NotoSans-Medium/12") as menu font.man
--min-dimension widthOnly show images with width >= width and height >= height.man
-m, --montageEnable montage mode.man
-w, --multiwindowDisable slideshow mode.man
--no-conversion-cacheWhen loading images via HTTP, ImageMagick or dcraw, feh will only load/convert them once and re-use the cached file on subsequent slideshow passes.man
--no-jump-on-resortDon't jump to the first image after resorting the filelist.man
-N, --no-menusDon't load or show any menus.man
--no-screen-clipBy default, window sizes are limited to the screen size.man
--no-xinerama(optional feature, enabled in this build) Disable Xinerama support.man
--on-last-slide holdSelect behaviour when trying to select the next image on the last slide (or the previous image on the first slide) in a slide show.man
-j, --output-dir directorySave files to directory when using --keep-http or the save_image or save_filelist command.man
-p, --preloadPreload images.man
-q, --quietDon't report non-fatal errors for failed loads.man
-z, --randomizeWhen viewing multiple files in a slideshow, randomize the file list before displaying.man
-r, --recursiveRecursively expand any directories in the command line arguments to the content of those directories, all the way down to the bottom level.man
--no-recursiveDon't recursively expand any directories.man
-R, --reload intReload filelist and current image after int seconds.man
-n, --reverseReverse the sort order.man
--scale-downScale images to fit window geometry (defaults to screen size when no geometry was specified).man
--scroll-step countScroll count pixels whenever scroll_up, scroll_down, scroll_left or scroll_right is pressed.man
-D, --slideshow-delay floatFor slideshow mode, wait float seconds between automatically changing slides.man
-S, --sort sort_typeSort file list according to image parameters.man
--start-at filenameStart the filelist at filename.man
-T, --theme themeLoad options from config file with name theme - see THEMES CONFIG SYNTAX for more info.man
-t, --thumbnailsSame as Index mode, but the thumbnails are clickable image launchers.man
--thumb-title stringSet title for windows opened from thumbnail mode.man
--title titleSet window title.man
-u, --unloadableDon't display images.man
-V, --verboseoutput useful information, progress bars, etc.man
-v, --versionoutput version information and exit.man
--version-sortWhen combined with --sort name, --sort filename, or --sort dirname: use natural sorting for file and directory names.man
--window-id windowidDraw to an existing X11 window by its ID windowid.man
--xinerama-index monitor(optional feature, enabled in this build) Override feh's idea of the active Xinerama monitor.man
--zoom percentZoom images by percent when in full screen mode or when window geometry is fixed.man
--zoom-step percentZoom images in and out by percent (default: 25) when using the zoom keys and buttons.man
-a, --alpha intWhen drawing thumbnails onto the background, set their transparency level to int (0 - 255).man
-b, --bg fileUse file as background for your montage.man
-X, --ignore-aspectBy default, the montage thumbnails will retain their aspect ratios, while fitting into thumb-width/-height.man
-H, --limit-height pixelsLimit the height of the montage.man
-W, --limit-width pixelsLimit the width of the montage, defaults to 800 pixels.man
-o, --output fileSave the created montage to file.man
-O, --output-only fileJust save the created montage to file without displaying it.man
-s, --stretchNormally, if an image is smaller than the specified thumbnail size, it will not be enlarged.man
-E, --thumb-height pixelsSet thumbnail height.man
-y, --thumb-width pixelsSet thumbnail width.man
--index-info formatShow image information based on format below thumbnails in index / thumbnail mode.man
-@, --title-font fontSet font to print a title on the index, if no font is specified, no title will be printed.man
-J, --thumb-redraw nRedraw thumbnail window every n images while generating thumbnails.man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.