Difference between revisions of "Feh"

From ArchWiki
Jump to: navigation, search
(added Codeline formatting; updated installation instructions to use the new styling phrasing)
m (codeline -> ic)
Line 10: Line 10:
  
 
==Usage==
 
==Usage==
feh is highly configurable. For a full list of options, run {{Codeline|feh --help}}.
+
feh is highly configurable. For a full list of options, run {{Ic|feh --help}}.
  
 
===As an image viewer===
 
===As an image viewer===
Line 17: Line 17:
 
  $ feh -g 640x480 -d -S filename /path/to/directory
 
  $ feh -g 640x480 -d -S filename /path/to/directory
  
* The {{Codeline|-g}} flag forces the images to appear no larger than 640x480
+
* The {{Ic|-g}} flag forces the images to appear no larger than 640x480
* The {{Codeline|-S filename}} flag sorts the images by file name
+
* The {{Ic|-S filename}} flag sorts the images by file name
  
 
This is just one example; there are many more options available should you desire more flexibility.
 
This is just one example; there are many more options available should you desire more flexibility.
Line 56: Line 56:
 
   /path/to/script %f -F -Z
 
   /path/to/script %f -F -Z
  
{{Codeline|-F}} and {{Codeline|-Z}} are feh arguments. {{Codeline|-F}} opens the image in fullscreen mode, and {{Codeline|-Z}} automatically zooms the image. Adding the {{Codeline|-q}} flag (quiet) suppresses error messages to the terminal when feh tries loading non-image files from the current folder.
+
{{Ic|-F}} and {{Ic|-Z}} are feh arguments. {{Ic|-F}} opens the image in fullscreen mode, and {{Ic|-Z}} automatically zooms the image. Adding the {{Ic|-q}} flag (quiet) suppresses error messages to the terminal when feh tries loading non-image files from the current folder.
  
 
===As a desktop wallpaper manager===
 
===As a desktop wallpaper manager===
Line 78: Line 78:
 
  sh ~/.fehbg &
 
  sh ~/.fehbg &
  
To change the background image, edit the file {{Filename|~/.fehbg}} which gets created after running the command {{Codeline|feh --bg-scale /path/to/image.file}} mentioned above.
+
To change the background image, edit the file {{Filename|~/.fehbg}} which gets created after running the command {{Ic|feh --bg-scale /path/to/image.file}} mentioned above.
  
 
====Random background image====
 
====Random background image====
To rotate the wallpaper randomly, create a script with the code below (e.g. {{Filename|wallpaper.sh}}). Make the script executable ({{Codeline|chmod +x wallpaper.sh}}) and call it from {{Filename|~/.xinitrc}}. You can also put the source directly in {{Filename|~/.xinitrc}} instead of in a separate file.
+
To rotate the wallpaper randomly, create a script with the code below (e.g. {{Filename|wallpaper.sh}}). Make the script executable ({{Ic|chmod +x wallpaper.sh}}) and call it from {{Filename|~/.xinitrc}}. You can also put the source directly in {{Filename|~/.xinitrc}} instead of in a separate file.
  
Change the {{Filename|~/.wallpaper}} directory to fit your setup and the {{Codeline|15m}} delay as you please (see {{Codeline|man sleep}} for options).
+
Change the {{Filename|~/.wallpaper}} directory to fit your setup and the {{Ic|15m}} delay as you please (see {{Ic|man sleep}} for options).
 
<pre>
 
<pre>
 
#!/bin/sh
 
#!/bin/sh

Revision as of 16:38, 11 December 2011


This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

feh is a lightweight and powerful image viewer that can also be used to manage the desktop wallpaper for standalone window managers lacking such features.

Installation

Template:Package Official is available in the Official Repositories:

# pacman -S feh

Usage

feh is highly configurable. For a full list of options, run feh --help.

As an image viewer

To quickly browse images in a specific directory, you can launch feh with the following arguments:

$ feh -g 640x480 -d -S filename /path/to/directory
  • The -g flag forces the images to appear no larger than 640x480
  • The -S filename flag sorts the images by file name

This is just one example; there are many more options available should you desire more flexibility.

File Browser Image Launcher

The following script, originally posted on the forum, is useful for file browsers. It will display your selected image in feh, but it will enable you to browse all other images in the directory as well, in their default order, i.e. as if you had run "feh *" and cycled through to the selected image.

The script assumes the first argument is the filename.

#!/bin/bash

shopt -s nullglob

if [[ ! -f $1 ]]; then
	echo "$0: first argument is not a file" >&2
	exit 1
fi

file=$(basename -- "$1")
dir=$(dirname -- "$1")
arr=()
shift

cd -- "$dir"

for i in *; do
	[[ -f $i ]] || continue
	arr+=("$i")
	[[ $i == $file ]] && c=$((${#arr[@]} - 1))
done

exec feh "$@" -- "${arr[@]:c}" "${arr[@]:0:c}"

Invoke the script with the selected image's path, followed by any additional arguments to feh. Here is an example of a launcher that you can use in a file browser:

 /path/to/script %f -F -Z

-F and -Z are feh arguments. -F opens the image in fullscreen mode, and -Z automatically zooms the image. Adding the -q flag (quiet) suppresses error messages to the terminal when feh tries loading non-image files from the current folder.

As a desktop wallpaper manager

feh can be used to manage the desktop wallpaper for window managers that lack desktop features, such as Openbox, Fluxbox, and xmonad.

When using GNOME, you must disable Nautilus from controlling the desktop. The easiest way is to run this command:

$ gconftool-2 --set /apps/nautilus/preferences/show_desktop --type boolean false

The following command is an example of how to set the initial background:

$ feh --bg-scale /path/to/image.file

Other scaling options include:

--bg-tile FILE
--bg-center FILE
--bg-max FILE
--bg-fill FILE

To restore the background on the next session, add the following to your startup file (e.g. Template:Filename, Template:Filename, etc.):

sh ~/.fehbg &

To change the background image, edit the file Template:Filename which gets created after running the command feh --bg-scale /path/to/image.file mentioned above.

Random background image

To rotate the wallpaper randomly, create a script with the code below (e.g. Template:Filename). Make the script executable (chmod +x wallpaper.sh) and call it from Template:Filename. You can also put the source directly in Template:Filename instead of in a separate file.

Change the Template:Filename directory to fit your setup and the 15m delay as you please (see man sleep for options).

#!/bin/sh

while true; do
	find ~/.wallpaper -type f \( -name '*.jpg' -o -name '*.png' \) -print0 |
		shuf -n1 -z | xargs -0 feh --bg-scale
	sleep 15m
done

This version does not fork as much, but this version does not recurse through directories:

#!/bin/bash

shopt -s nullglob
 
cd ~/.wallpaper

while true; do
	files=()
	for i in *.jpg *.png; do
		[[ -f $i ]] && files+=("$i")
	done
	range=${#files[@]}

	((range)) && feh --bg-scale "${files[RANDOM % range]}"

	sleep 15m
done