Configuring

XAWP supports both configuration files and commands. Using configuration files is the best choice for stable desktop rices.

Editing the configuration file

A configuration file template can be found here.

Locating the config file

The default configuration file is located in $HOME/.config/xawp/xawp.conf.
If it does not exist, you can copy the template from here.

Another option would be to use another configuration file that can be run with the xawp -c /path/to/conf command. See the arguments wiki page for more info about the -c argument.
It can be located anywhere with the condition to have read permissions.

Parameters

Path

The path parameter contains the path to the directory containing the animation frames. To locate it, open a terminal in the frames directory and execute pwd. This will print the location of the directory which will be put in the path parameter.

path = "/home/foo/wallgif"

Time

The time parameter sets the time interval between frames. It accepts a floating number, the integer representing the seconds and the float representing 10^2 of a millisecond. For instance, setting the value as 1.83 sets the time interval between 2 frames to 1 second and 830 milliseconds, or 1830 milliseconds. It is obviously a big interval and it can be less than 1.0 as well.

time = 0.12

Debug

If the debug parameter is true, debug info will start displaying on the terminal. Otherwise, XAWP would print just normal output and errors. It's likely used for catching bugs(not the ones from the kitchen).

debug=true

Static image wallpaper

By default, the static-wallpaper parameter is commented with a '#' at the beginning (#static-wallpaper). If uncommented, XAWP would not loop anymore in the background but display a static background image.

The value should contain a path to a real image, like in the example below. If the path does not exist or it's wrong, visual garbage may be set as wallpaper.

static-wallpaper="/home/foo/wallpaper.png"

For details about how to use XAWP, see the usage wiki page.