Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
F
feh
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Package Registry
Model registry
Operate
Environments
Terraform modules
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
derf
feh
Commits
8d55bad6
Commit
8d55bad6
authored
8 years ago
by
Fahad Hossain
Committed by
GitHub
8 years ago
Browse files
Options
Downloads
Patches
Plain Diff
Convert README to markdown
Looks prettier
parent
0e479941
No related branches found
Branches containing commit
No related tags found
Tags containing commit
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+136
-0
136 additions, 0 deletions
README.md
with
136 additions
and
0 deletions
README
→
README
.md
+
136
−
0
View file @
8d55bad6
feh - Imlib2 based image viewer
-------------------------------
# feh
Imlib2 based image viewer
---
*
<
http://feh.finalrewind.org/
>
*
<
http://linuxbrit.co.uk/feh/
>
*
http://feh.finalrewind.org/
*
http://linuxbrit.co.uk/feh/
*
#feh on irc.oftc.net
Dependencies
---
---------
---
*
Imlib2
*
libcurl (disable with make curl=0)
...
...
@@ -20,77 +21,101 @@ If built with exif=1:
*
libexif12
Recommended
---
--------
---
*
jpegtran (supplied by the jpeg library, for lossless image rotation)
*
convert (supplied by ImageMagick, can be used to load unsupported formats)
Installation
------------
For end users:
---
**For end users:**
```
bash
$
make
$
sudo
make
install
app
=
1
```
For package maintainers and users who do not want feh to install its
icons into /usr/share:
**
For package maintainers and users who do not want feh to install its
icons into /usr/share:
**
```
bash
$
make
$
sudo
make
install
```
Explanation: feh ships some icons and an X11 desktop entry, which allow it to
**
Explanation:
**
feh ships some icons and an X11 desktop entry, which allow it to
be used from file managers, desktop menus and similar. However, installing
icons to /usr/local/share/... does not seem to work reliable in all cases.
Because of this, when using "make install app=1", feh will install its icons
to /usr/share/..., even though they technically belong into /usr/local.
ZSH Completion for feh is available at
<
http://git.finalrewind.org/zsh/plain/etc/completions/_feh
>
ZSH Completion for feh is available
[
here
](
http://git.finalrewind.org/zsh/plain/etc/completions/_feh
)
Make flags
----------
Flags can be used to control the build and installation process, e.g. via "make
flag=bool", "make install flag=bool", or "export flag=bool; make && make
install". For example, "make xinerama=0 debug=1" will disable Xinerama support
and produce a debug build.
Flags can be used to control the build and installation process.
e.g.
```
bash
make
flag
=
bool
```
```
bash
make
install
flag
=
bool
```
or
```
bash
export
flag
=
bool
make
&&
make
install
```
For example,
`make xinerama=0 debug=1`
will disable Xinerama support and produce a debug build.
Available flags are:
* app (default 0) - install icons to /usr/share, regardless of DESTDIR
and PREFIX, and call gtk-update-icon-cache afterwards
* cam (default 0) - install deprecated feh-cam und gen-cam-menu scripts
* curl (default 1) - use libcurl to view http:// and similar images
* debug (default 0) - debug build, enables --debug
* exif (default 0) - Builtin EXIF tag display support
* help (default 0) - include help text (refers to the manpage otherwise)
* stat64 (default 0) - Support CIFS shares from 64bit hosts on 32bit machines
* xinerama (default 1) - Support Xinerama/XRandR multiscreen setups
So, by default libcurl and Xinerama are enabled, the rest is disabled.
Additionally, the standard variables PREFIX and DESTDIR are supported.
PREFIX (default /usr) controls where the application and its data files
will be installed. It must be set both during "make" and "make install".
DESTDIR (default empty) sets the installation root during "make install". It
| Flag | Default value | Description |
| :--- | :---: | :--- |
| app | 0 | install icons to /usr/share, regardless of
`DESTDIR`
and
`PREFIX, and call gtk-update-icon-cache afterwards |
| cam | 0 | install deprecated feh-cam und gen-cam-menu scripts |
| curl | 1 | use libcurl to view http:// and similar images |
| debug | 0 | debug build, enables `
--debug
` |
| exif | 0 | Builtin EXIF tag display support |
| help | 0 | include help text (refers to the manpage otherwise) |
| stat64 | 0 | Support CIFS shares from 64bit hosts on 32bit machines |
| xinerama | 1 | Support Xinerama/XRandR multiscreen setups |
So, by default **libcurl** and **Xinerama** are enabled, the rest is disabled.
Additionally, the standard variables `
PREFIX
` and `
DESTDIR
` are supported.
**PREFIX _(default: /usr)_** controls where the application and its data files
will be installed. It must be set both during `
make
` and `
make install
`.
**DESTDIR _(default: empty)_** sets the installation root during "make install". It
is mostly useful for package maintainers.
Note: config.mk is designed so that in most cases, you can set environment
**
Note:
**
config.mk is designed so that in most cases, you can set environment
variables instead of editing it. E.g.:
```bash
CFLAGS='-g -Os' make
export DESTDIR=/tmp/feh PREFIX=/usr; make && make install
```
```bash
export DESTDIR=/tmp/feh PREFIX=/usr
make && make install
```
Builtin EXIF support is maintained by Dennis Real, see
<https://github.com/reald/feh>.
Builtin EXIF support is maintained by Dennis Real, [here](https://github.com/reald/feh).
Testing (non-X)
---------------
```bash
$ make test
```
Requires perl >= 5.10 with Test::Command. The tests are non-interactive and
Requires
**
perl >= 5.10
**
with
`
Test::Command
`
. The tests are non-interactive and
work without X, so they can safely be run even on a headless buildserver.
...
...
@@ -103,7 +128,9 @@ Requires
* twm
* Xephyr
```bash
$ make test-x11
``
`
Be aware that this is quite experimental, so far the X-tests have only been
run on one machine. So they may or may not work for you.
**
_
Be aware that this is quite experimental, so far the X-tests have only been
run on one machine. So they may or may not work for you.
_
**
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment