macOS
Homebrewverified · 100%
brew install fehlocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install fehMacPorts ports tree · graphics/feh/Portfile · source: api.github.com
brew
Install feh with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper
X11 image viewer. Version 3.12.2 via Homebrew; verified 2026-05-07.
install
Additional install commands
Linux
Alpine Linux apkverified · 92%
sudo apk add fehAlpine Linux edge package indexes · feh · source: dl-cdn.alpinelinux.org
Debian aptverified · 92%
sudo apt install fehDebian stable package indexes · feh · source: deb.debian.org
Fedora dnfverified · 92%
sudo dnf install fehFedora Rawhide package metadata · feh · source: dl.fedoraproject.org
Nixverified · 92%
nix profile install nixpkgs#fehnixpkgs package indexes · pkgs/by-name/fe/feh/package.nix · source: api.github.com
Arch Linux pacmanverified · 92%
sudo pacman -S fehArch Linux sync databases · feh · source: geo.mirror.pkgbuild.com
openSUSE zypperverified · 92%
sudo zypper install fehopenSUSE Tumbleweed package metadata · feh · source: download.opensuse.org
overview
Package summary
X11 image viewer
Project links
Commands and aliases
- feh
history
Project history and usage
feh is a lightweight X11 image viewer and cataloguer aimed at command-line users. Its official manual and homepage emphasize a Unix-style workflow: run it from a shell, feed it files, directories, URLs, or filelists, and control it through options, key bindings, mouse bindings, stdin, and signals.
Project history
The project has been maintained for many years as a small, focused image viewer built around imlib2 and X11 rather than a desktop photo-management stack. The public release archive documents continuous 1.x, 2.x, and 3.x releases from at least 2010 through 2026, with release notes focused on practical viewer behavior, build portability, security hardening, and window-manager edge cases.
feh 2.0 was released in 2011 according to the project changelog, and the 3.x line is still active: the official archive lists feh 3.12.2 on 2026-05-07. Recent releases continue the same pattern, including fixes for Xwayland focus behavior, reproducible manual builds, filelist parsing, rendering bugs, and safer shell format specifiers for actions and info commands.
Adoption history
The official homepage notes packaging across multiple Unix and Unix-like systems, including Arch Linux, Debian, FreeBSD, OpenBSD, and Ubuntu. Homebrew, MacPorts, Nix, Fedora, openSUSE, Alpine, and other package collections also carry it in the supplied package-manager metadata, which matches feh's long role as a standard small image viewer for lightweight X11 environments.
How it is used
Common usage centers on fast image viewing from the shell, slideshows over directories, thumbnail and index generation, listing image metadata, opening URLs when libcurl support is enabled, and setting X11 backgrounds. The manual also documents custom shell actions, filelists, captions, EXIF display, configurable keys/buttons, and cache behavior.
Its wallpaper-setting mode is one reason package users keep it installed even when they use another image viewer interactively: window-manager and dotfile setups can call feh from startup scripts to set backgrounds without pulling in a desktop environment.
Why package nerds care
feh matters to package-manager culture because it is the classic small-tool answer to image viewing on X11: scriptable, dependency-light, easy to build, and comfortable in shell pipelines and window-manager configs.
It also illustrates a maintenance style package maintainers like: conservative release notes, clear compile-time feature flags, signed tarballs, a man page, and a project homepage that documents downstream packaging without turning the tool into a platform.
Timeline
- 2010: Official archive shows active 1.x releases, including feh 1.3.5 and later 1.x versions.
- 2011: feh 2.0 released.
- 2019: feh 3.0 released.
- 2026: feh 3.12.2 released on 2026-05-07.
Related projects
- imlib2 is the image-loading/rendering library underlying feh's supported image formats.
- ImageMagick can be used by feh for optional conversion of otherwise unsupported file types.
- xwallpaper, hsetroot, and display from ImageMagick occupy adjacent shell-driven image and wallpaper workflows, but feh remains popular because it combines viewing, listing, slideshow, and wallpaper duties.
Sources
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for feh. Nucleus package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Installs with 6 runtime dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
$XDG_CONFIG_HOME/feh/themes$XDG_CONFIG_HOME/feh/keys$XDG_CONFIG_HOME/feh/buttons~/.config/feh/themes~/.config/feh/keys~/.config/feh/buttons/etc/feh/themes/etc/feh/keys/etc/feh/buttons
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
feh | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version3.12.2
manager updated2026-05-07
local dataok
upstreamnot checked
latest detectednot detected
- infoRelease/tag comparison is only available for GitHub repositories.https://feh.finalrewind.org/none confidence
install metadata
Package metadata
| Package key | brew:feh |
|---|---|
| Version | 3.12.2 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/feh |
| Homepage | https://feh.finalrewind.org/ |
| Repository | https://git.finalrewind.org/feh |
| Upstream docs | https://feh.finalrewind.org/ |
| License | MIT-feh |
| Source archive | https://feh.finalrewind.org/feh-3.12.2.tar.bz2 |
| Last updated | 2026-05-07T21:04:39Z |
| Pulse | updated |
| Dependencies | imlib2, libexif, libpng, libx11, libxinerama, libxt |
| Uses from macOS | curl |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | feh |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Debian apt95%
feh 3.10.3-1
imlib2 based image viewer
sudo apt install feh- Section: graphics
- Architecture: amd64
- 8 dependencies
- 1 optional deps
- normalized package name match
- Matched by: Feh
Nix95%
feh
nix profile install nixpkgs#feh- normalized package name match
- Matched by: Feh
Ubuntu apt95%
feh 3.10.1-1build3
imlib2 based image viewer
sudo apt install feh- Section: universe/graphics
- Architecture: amd64
- 8 dependencies
- 1 optional deps
- normalized package name match
- Matched by: Feh
apk95%
feh 3.12.2-r0
Fast, lightweight image viewer which uses imlib2
sudo apk add feh- License: MIT-feh
- Architecture: x86_64
- Source Package: feh
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Feh
apk95%
feh-doc 3.12.2-r0
Fast, lightweight image viewer which uses imlib2 (documentation)
sudo apk add feh-doc- License: MIT-feh
- Architecture: x86_64
- Source Package: feh
- normalized package name match
- Matched by: Feh
dnf95%
feh 3.12.2-2.fc45
Fast command line image viewer using Imlib2
sudo dnf install feh- License: MIT
- Category: Unspecified
- Architecture: x86_64
- Source Package: feh
- 10 dependencies
- 3 provides
- normalized package name match
- Matched by: Feh
pacman95%
feh 3.12.2-1
Fast and light imlib2-based image viewer
sudo pacman -S feh- License: MIT
- Architecture: x86_64
- 13 dependencies
- 1 optional deps
- normalized package name match
- Matched by: Feh
zypper95%
feh 3.11.1-1.4
X11 image viewer
sudo zypper install feh- License: LGPL-2.0-or-later AND MIT
- Category: Unspecified
- Architecture: x86_64
- Source Package: feh
- 12 dependencies
- 3 provides
- normalized package name match
- Matched by: Feh
zypper95%
feh-zsh-completion 3.11.1-1.4
ZSH Completion for feh
sudo zypper install feh-zsh-completion- License: LGPL-2.0-or-later AND MIT
- Category: Unspecified
- Architecture: noarch
- Source Package: feh
- 1 provides
- normalized package name match
- Matched by: Feh
MacPorts95%
feh
sudo port install feh- normalized package name match
- Matched by: Feh
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment