Difference between revisions of "Package:Feh"

From Funtoo
Jump to navigation Jump to search
(Updated some <tt>s to <code>, added information about another flag.)
Line 26: Line 26:
== Using feh ==
== Using feh ==
=== Set desktop background ===
=== Set desktop background ===
<tt>feh</tt> has several options for setting your desktop background:
<code>feh</code> 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.
* <code>--bg-center</code>: 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.
* <code>--bg-scale</code>: 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.
* <code>--bg-fill</code>: Similar to <code>--bg-scale</code> 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.
* <code>--bg-max</code>: Similar to <code>--bg-fill</code>, 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.
* <code>--bg-tile</code>: Tile the image across the screen.
* <code>--random <name of directory to choose random image from></code>: Allow feh to choose a random wallpaper from a directory of pictures.


Here is an example:
Here is an example:

Revision as of 22:57, November 21, 2014

Feh

   Tip

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.
  • --random <name of directory to choose random image from>: Allow feh to choose a random wallpaper from a directory of pictures.

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 &
...