Skip to content
Wallpaper Daemon
C CMake
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.gitignore
CMakeLists.txt
ChangeLog
LICENSE
README
config.h.in
wallpaperd.cfg

README

wallpaperd is a small application that takes care of setting the
background image. wallpaperd was created due to a friend requesting to
have different wallpapers on the different workspaces in pekwm.

=== Features ===

wallpaperd now supports:

* Changing wallpaper on workspace change.
* Changing wallpaper every X amount of time.
* Changing wallpaper based on a GNOME background.xml file.
* Support for specifying centered, zoomed, tiled and fill image modes.
* Selecting wallpaper based on workspace number.
* Selecting wallpaper based on workspace name.
* RANDR support setting the wallpaper on each screen.
* RANDR support re-setting the wallpaper on screen resolution changes.
* Setting background Atom hint.

plans for implementing support for:

* RANDR support having per screen wallpapers.

=== Supported platforms ===

wallpaperd is known to compile and run on the following platforms:

* Ubuntu 10.04
* OpenBSD 4.6
* OS X 10.6
* OpenSolaris 2009.06, both with GCC and Sun Studio compiler. Requires
  SUNWgnome-common-devel and SUNWxorg-headers packages. Imlib2 is not included
  in the standard package repository.

=== Installation ===

wallpaperd requires:

* Xlib, X11 development files.
* Imlib2, Image loading and manipulation

To install (download, extract, configure, compile and install) execute:

 $ wget https://projects.pekdon.net/projects/wallpaperd/files/wallpaperd-0.2.2.tar.gz
 $ tar xvzf wallpaperd-0.2.2.tar.gz
 $ cd wallpaperd-0.2.2
 $ ./configure
 $ make
 $ sudo make install

=== Configuration ===

wallpaperd is configured in ~/.wallpaperd.cfg which is a simple
section free ini style configuration file.

An example configuration file setting the wallpaper based on workspace
name, having special wallpapers for work and www workspaces and a default
image named default.jpg:

 path.search=~/Pictures:~/Pictures/Wallpapers:/usr/share/backgrounds
 config.mode=NAME
 wallpaper.default.image=default.jpg
 wallpaper.default.mode=CENTERED
 wallpaper.work.image=work.jpg
 wallpaper.work.mode=ZOOMED
 wallpaper.www.image=www.jpg
 wallpaper.www.mode=TILED
You can’t perform that action at this time.