# 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 ```sh sudo av install brew:feh ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install feh ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install feh ``` Evidence: MacPorts ports tree: graphics/feh/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add feh ``` Evidence: Alpine Linux edge package indexes: feh from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install feh ``` Evidence: Debian stable package indexes: feh from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install feh ``` Evidence: Fedora Rawhide package metadata: feh from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#feh ``` Evidence: nixpkgs package indexes: pkgs/by-name/fe/feh/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S feh ``` Evidence: Arch Linux sync databases: feh from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install feh ``` Evidence: openSUSE Tumbleweed package metadata: feh from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:feh - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.12.2 - **Source summary:** X11 image viewer - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT-feh - **Source archive:** - **Last updated:** 2026-05-07T21:04:39Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - feh (cli) - feh (alias) ## Dependencies - imlib2 - libexif - libpng - libx11 - libxinerama - libxt ## Uses from macOS - curl ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 3.12.2 - Package-manager updated: 2026-05-07 - Local data: ok - Upstream repository: https://feh.finalrewind.org/ - info: Release/tag comparison is only available for GitHub repositories. ## 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 Notes 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. ## 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 - 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 ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** feh - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Debian apt - feh - 3.10.3-1: normalized package name match | Debian stable package indexes: feh from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | imlib2 based image viewer | https://feh.finalrewind.org/ - Nix - feh: normalized package name match | nixpkgs package indexes: pkgs/by-name/fe/feh/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - feh - 3.10.1-1build3: normalized package name match | Ubuntu 24.04 LTS package indexes: feh from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | imlib2 based image viewer | https://feh.finalrewind.org/ - apk - feh - 3.12.2-r0: normalized package name match | Alpine Linux edge package indexes: feh from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fast, lightweight image viewer which uses imlib2 | https://feh.finalrewind.org - apk - feh-doc - 3.12.2-r0: normalized package name match | Alpine Linux edge package indexes: feh-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fast, lightweight image viewer which uses imlib2 (documentation) | https://feh.finalrewind.org - dnf - feh - 3.12.2-2.fc45: normalized package name match | Fedora Rawhide package metadata: feh from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Fast command line image viewer using Imlib2 | https://feh.finalrewind.org - pacman - feh - 3.12.2-1: normalized package name match | Arch Linux sync databases: feh from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Fast and light imlib2-based image viewer | https://feh.finalrewind.org/ - zypper - feh - 3.11.1-1.4: normalized package name match | openSUSE Tumbleweed package metadata: feh from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | X11 image viewer | https://feh.finalrewind.org/ - zypper - feh-zsh-completion - 3.11.1-1.4: normalized package name match | openSUSE Tumbleweed package metadata: feh-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | ZSH Completion for feh | https://feh.finalrewind.org/ - MacPorts - feh: normalized package name match | MacPorts ports tree: graphics/feh/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata. - [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [imlib2](https://www.automicvault.com/pkg/brew/imlib2/) - Runtime dependency declared by Homebrew. - [libpng](https://www.automicvault.com/pkg/brew/libpng/) - Runtime dependency declared by Homebrew. - [plowshare](https://www.automicvault.com/pkg/brew/plowshare/) - Popular package that depends on this formula. - [aview](https://www.automicvault.com/pkg/brew/aview/) - Shares av.db curated category or tags: cli, image-viewer, media. - [pqiv](https://www.automicvault.com/pkg/brew/pqiv/) - Shares av.db curated category or tags: cli, image-viewer, media. - [timg](https://www.automicvault.com/pkg/brew/timg/) - Shares av.db curated category or tags: cli, image-viewer, media. - [tpix](https://www.automicvault.com/pkg/brew/tpix/) - Shares av.db curated category or tags: cli, image-viewer, media. - [viu](https://www.automicvault.com/pkg/brew/viu/) - Shares av.db curated category or tags: cli, image-viewer, media. - [xplanet](https://www.automicvault.com/pkg/brew/xplanet/) - Shares av.db curated category or tags: cli, media, wallpaper, x11. - [catimg](https://www.automicvault.com/pkg/brew/catimg/) - Shares av.db curated category or tags: cli, image-viewer, media. - [fontconfig](https://www.automicvault.com/pkg/brew/fontconfig/) - Shares av.db curated category or tags: cli, media, x11. - [xfig](https://www.automicvault.com/pkg/brew/xfig/) - Local package facts share a topical domain. Shared terms: cli, libpng, libx11, libxt, media. ## Combined YAML source View the package source record on GitHub. [combined/feh.yml](https://github.com/automic-vault/db/blob/main/combined/feh.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph