{"id":13547045,"url":"https://github.com/derf/feh","last_synced_at":"2025-12-24T13:57:43.540Z","repository":{"id":40211474,"uuid":"504149","full_name":"derf/feh","owner":"derf","description":"a fast and light image viewer","archived":false,"fork":false,"pushed_at":"2024-12-02T16:23:50.000Z","size":7531,"stargazers_count":1574,"open_issues_count":236,"forks_count":161,"subscribers_count":31,"default_branch":"master","last_synced_at":"2024-12-02T17:32:02.367Z","etag":null,"topics":["image-viewer","imlib2","x11"],"latest_commit_sha":null,"homepage":"https://feh.finalrewind.org","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/derf.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2010-02-05T17:15:56.000Z","updated_at":"2024-12-02T16:23:55.000Z","dependencies_parsed_at":"2024-06-29T18:29:12.652Z","dependency_job_id":"307947fa-8d64-495a-b200-0bdfaaad4c59","html_url":"https://github.com/derf/feh","commit_stats":null,"previous_names":[],"tags_count":114,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derf%2Ffeh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derf%2Ffeh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derf%2Ffeh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derf%2Ffeh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/derf","download_url":"https://codeload.github.com/derf/feh/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246880180,"owners_count":20848819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["image-viewer","imlib2","x11"],"created_at":"2024-08-01T12:00:50.144Z","updated_at":"2025-12-24T13:57:43.486Z","avatar_url":"https://github.com/derf.png","language":"C","funding_links":[],"categories":["C","Image Viewer","UI Apps/Tools","others","Packages"],"sub_categories":["Image Viewer","Background setting utilities and generators"],"readme":"# feh - Image Viewer and Cataloguer\n\n**feh** is a light-weight, configurable and versatile image viewer.\nIt is aimed at command line users, but can also be started from graphical file\nmanagers. Apart from viewing images, it can compile text and thumbnail\nlistings, show (un)loadable files, set X11 backgrounds, and more.\n\nFeatures include filelists, various image sorting modes, custom action scripts,\nand image captions. feh can be controlled by configurable keyboard and mouse\nshortcuts, terminal input and signals.  When no file arguments or filelists are\nspecified, feh displays all files in the current directory.\n\nThis README focuses on installation and contribution instructions.  See the\n[feh homepage](https://feh.finalrewind.org/) and the\n[feh(1) manual](https://man.finalrewind.org/1/feh/) for usage instructions.\n\n## Dependencies\n\n * Imlib2\n * libcurl (disable with `curl=0`)\n * libpng\n * libX11\n * libXt\n * libXinerama (disable with `xinerama=0`)\n\nOnly when building with `exif=1`:\n\n * libexif-dev\n * libexif12\n\nOnly when building with `magic=1`:\n\n * libmagic\n\n## Build Process\n\nfeh has been packaged for a variety of distributions, including\n[Arch Linux](https://archlinux.org/packages/extra/x86_64/feh/),\n[Debian](https://packages.debian.org/search?keywords=feh\u0026exact=1),\n[FreeBSD](https://www.freshports.org/graphics/feh), and\n[Ubuntu](https://packages.ubuntu.com/search?keywords=feh\u0026exact=1).\nYou can configure, compile and install a custom version as follows.\n\n### Configuration\n\nfeh's build process uses make flags to enable/disable optional features and\nfine-tune the build and installation process. It uses (hopefully) reasonable\ndefaults, so you can skip this section if you like.\n\nMake flags can be passed as **make** arguments or set as environment variables,\nlike so:\n\n```bash\n$ make flag=bool\n$ make install flag=bool\n```\nor\n```bash\n$ export flag=bool\n$ make \u0026\u0026 make install\n```\n\nThe following flags are respected by the makefile. A default value of **1**\nindicates that the corresponding feature is enabled by default.\n\n| Flag | Default value | Description |\n| :--- | :---: | :--- |\n| app  | 0 | install icons to /usr/share, regardless of `DESTDIR` and `PREFIX`, and call gtk-update-icon-cache afterwards |\n| curl | 1 | use libcurl to view https:// and similar images |\n| debug | 0 | debug build, enables `--debug` |\n| exif | 0 | Builtin EXIF tag display support |\n| help | 0 | include help text (refers to the manpage otherwise) |\n| inotify | 0 | enable inotify, needed for `--auto-reload` |\n| stat64 | 0 | Support CIFS shares from 64bit hosts on 32bit machines |\n| magic | 0 | Use libmagic to filter unsupported file formats |\n| mkstemps | 1 | Whether your libc provides `mkstemps()`. If set to 0, feh will be unable to load gif images via libcurl |\n| verscmp | 1 | Whether your libc provides `strvercmp()`. If set to 0, feh will use an internal implementation. |\n| xinerama | 1 | Support Xinerama/XRandR multiscreen setups |\n\nFor example, `make xinerama=0 debug=1` will disable Xinerama support and\nproduce a debug build; libcurl and natural sorting support will remain enabled.\n\nAdditionally, it supports the standard variables `CFLAGS`, `LDLIBS`, `PREFIX`,\nand `DESTDIR`.\n\n**PREFIX _(default: /usr/local)_** controls where the application and its data files\nwill be installed. It must be set both during `make` and `make install`.\n\n**DESTDIR _(default: empty)_** sets the installation root during \"make install\". It\nis mostly useful for package maintainers.\n\n**Note:** Defaults are specified in `config.mk`. It is designed so that in most\ncases, you can set environment variables instead of editing it. E.g.:\n\n```bash\n$ CFLAGS='-g -Os' make\n```\n```bash\n$ export DESTDIR=/tmp/feh PREFIX=/usr\n$ make \u0026\u0026 make install\n```\n\nBuiltin EXIF support is maintained by Dennis Real, [here](https://github.com/reald/feh).\n\n### Installation\n\nAdd your own make flags to the following examples as needed.\n\n**For end users:**\n```bash\n$ make\n$ sudo make install app=1\n```\n\n**For package maintainers and users who do not want feh to install its\nicons into /usr/share:**\n```bash\n$ make\n$ sudo make install\n```\n\n**Explanation:** feh ships some icons and an X11 desktop entry, which allow it to\nbe used from file managers, desktop menus and similar. However, installing\nicons to /usr/local/share/... does not seem to work reliably.\nBecause of this, when using \"make install app=1\", feh will install its icons\nto /usr/share/..., even though they technically belong into /usr/local.\n\n[ZSH completion for\nfeh](https://git.finalrewind.org/zsh/plain/etc/completions/_feh) is also\navailable.\n\n## Testing (non-X11)\n\nThe non-X11 parts of feh can be automatically tested by running\n\n```bash\n$ make test\n```\nThis requires **perl \u003e= 5.10** and the perl module `Test::Command`. Tests are\nnon-interactive and do not require a running X11, so they can safely be run on\na headless buildserver.\n\n## Contributing\n\nBugfixes are always welcome, just open a pull request :)\n\nBefore proposing a new feature, please consider the scope of feh: It is an\nimage viewer and cataloguer, not an image editor or similar. Also, its option\nlist is already pretty long. Please discuss your ideas in a feature request\nbefore opening a pull request in this case. Also, keep in mind that feh is\ndeveloped as a hobby project and that there is absolutely no obligation for\nanyone to implement requested features or review merge requests.\n\nPlease keep in mind that feh's options, key bindings and format specifiers are\ndocumented in two different places: The manual (man/feh.pre) and the help text\n(src/help.raw). Although the help is not compiled in by default, it should be\nkept up-to-date. On space-constrained embedded systems, it may be more useful\nthan the (significantly larger) man page.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderf%2Ffeh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fderf%2Ffeh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderf%2Ffeh/lists"}