Difference between pages "Form:Ebuild" and "Package:Feh"
Line 1: | Line 1: | ||
{{Ebuild | |||
|Summary=A fast, lightweight imageviewer using imlib2 | |||
|CatPkg=media-gfx/feh | |||
|Maintainer= | |||
|Homepage=http://feh.finalrewind.org/ | |||
}} | |||
=== What is feh? === | |||
<blockquote> | |||
feh is an X11 image viewer aimed mostly at console users. Unlike most other viewers, it does not have a fancy GUI, but simply displays images. It is controlled via commandline arguments and configurable key/mouse actions.[http://feh.finalrewind.org/ Feh homepage] | |||
</blockquote> | |||
== USE-Flags == | |||
;<code>curl</code>: Add support for the Client-Side URL transfer library. | |||
;<code>debug</code>: Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces, see http://www.gentoo.org/proj/en/qa/backtraces.xml. | |||
;<code>exif</code>: Add support for reading EXIF headers from JPEG and TIFF images. | |||
;<code>xinerama</code>: Add support for the xinerama X11 extension, which is mandator if you work in a multiple monitor setup. | |||
== | == Installing feh == | ||
After adding your USE flags (or not) to <tt>/etc/portage/package.use/feh</tt>, you can emerge feh: | |||
<console> | |||
###i## emerge feh | |||
</console> | |||
== Using feh == | |||
=== Set desktop background === | |||
<tt>feh</tt> has several options for setting your desktop background: | |||
* <tt>--bg-center</tt>: Center the image file on the background. If the image file is smaller in resolution than the screen resolution, it will have black borders around it. | |||
* <tt>--bg-scale</tt>: Fit the image to the background without repeating it, cutting parts of the image off, or using black borders. Because of these changes, the aspect ratio is not preserved. | |||
* <tt>--bg-fill</tt>: Similar to <tt>--bg-scale</tt> except that it tries to fill the image to the screen while maintaining its aspect ratio. This may result in parts of the image being cut off. | |||
* <tt>--bg-max</tt>: Similar to <tt>--bg-fill</tt>, except that scales the image to the maximum size that fits the screen. This leads to black borders on one side. | |||
* <tt>--bg-tile</tt>: Tile the image across the screen. | |||
Here is an example: | |||
<console> | |||
###i## feh --bg-scale ~/path/to/picture.jpg | |||
</console> | |||
=== Source fehbg to set your wallpaper in Openbox === | |||
After you have run <tt>feh</tt> one time, the directory of the image file is stored in <tt>~/.fehbg</tt>. This file can be sourced in your <tt>.config/openbox/autostart</tt> to load the picture instead of typing out <tt>feh --bg-scale /picture/location.jpg</tt>: | |||
{{ | {{file|name=~/.config/openbox/autostart|desc= |body= | ||
... | |||
~/.fehbg & | |||
... | |||
}} | |||
{{PageNeedsUpdates}} | |||
{{EbuildFooter}} |
Revision as of 01:48, September 16, 2014
Feh
We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.
What is feh?
feh is an X11 image viewer aimed mostly at console users. Unlike most other viewers, it does not have a fancy GUI, but simply displays images. It is controlled via commandline arguments and configurable key/mouse actions.Feh homepage
USE-Flags
curl
- Add support for the Client-Side URL transfer library.
debug
- Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces, see http://www.gentoo.org/proj/en/qa/backtraces.xml.
exif
- Add support for reading EXIF headers from JPEG and TIFF images.
xinerama
- Add support for the xinerama X11 extension, which is mandator if you work in a multiple monitor setup.
Installing feh
After adding your USE flags (or not) to /etc/portage/package.use/feh, you can emerge feh:
root # emerge feh
Using feh
Set desktop background
feh has several options for setting your desktop background:
- --bg-center: Center the image file on the background. If the image file is smaller in resolution than the screen resolution, it will have black borders around it.
- --bg-scale: Fit the image to the background without repeating it, cutting parts of the image off, or using black borders. Because of these changes, the aspect ratio is not preserved.
- --bg-fill: Similar to --bg-scale except that it tries to fill the image to the screen while maintaining its aspect ratio. This may result in parts of the image being cut off.
- --bg-max: Similar to --bg-fill, except that scales the image to the maximum size that fits the screen. This leads to black borders on one side.
- --bg-tile: Tile the image across the screen.
Here is an example:
root # feh --bg-scale ~/path/to/picture.jpg
Source fehbg to set your wallpaper in Openbox
After you have run feh one time, the directory of the image file is stored in ~/.fehbg. This file can be sourced in your .config/openbox/autostart to load the picture instead of typing out feh --bg-scale /picture/location.jpg:
~/.config/openbox/autostart
...
~/.fehbg &
...