Usage

XAWP is an animated wallpaper player written with the Imlib2 library for X11 desktops such as GNU/Linux or FreeBSD(and more).

The basics of it are very simple: Every frame will have it's own image files which XAWP will display each with specific time interval and repeat.

It's uses a lot resources such as RAM and CPU. A simple animated wallpaper with 15 frames and with a resolution of 1080x1920 (1080p/FullHD) can easily use 130MiB of RAM and if running on an old processor(before Intel Core Duo), the CPU usage can be quite noticeable.

It is not supposed to run in modern Desktop Environments such as KDE Plasma, Cinnamon, GNOME(and more), but with thinkering it can be done. Instead, XAWP is written for primitive X11 Window Managers such as dwm.

Unlike most FOSS Animated Wallpaper Players/Engines, XAWP can run along with screen compositors such as compton or it's fork, picom. So you can actually see the animated wallpaper in a transparent terminal or window.

Running XAWP

Before running, XAWP needs to be configured.
To see how to configure XAWP, check the configuring wiki page.

Automatically

If using startx, .xinitrc needs to contain the xawp & command, with arguments at your choice:

# .xinitrc

xawp &  # Execute XAWP to run in background
exec dwm > /home/foo/.dwm.log  # Execute dwm Window Manager

Manually

XAWP can also be run manually after the Window Manager started running. Just execute xawp with arguments at your choice. You can also add & at the end to still be able to run commands in the terminal, or append setsid to the begining of the program. Note that if you close the shell or terminal, xawp will be killed when not using setsid.

# With child process ID
foo$ xawp &

# With detached process ID
foo$ setsid xawp

If you have a command-like menu such as dmenu, you can use that as well and you wouldn't need to bother running a terminal.