awww-0.12.0

Introduction to awww

The awww (Answer to your Wayland Wallpaper Woes) package provides a powerful wallpaper daemon for Wayland, controlled at runtime.

Note

An Internet connection is needed for building this package. The system certificate store may need to be set up with make-ca before building this package.

Rename the file download(s) before extracting:

mv -v v0.12.0.tar.gz awww-v0.12.0.tar.gz

awww Dependencies

Required

Rustc, Wayland, and Wayland-Protocols

Optional

dav1d and scdoc-1.11.4 (to build the man pages)

Installation of awww

Note

This package expands to the directory awww.

Install awww by running the following commands:

cargo build --release

To test the results, issue: cargo test --release.

If you installed scdoc and wish to build the man pages, execute the following commands:

./doc/gen.sh

Now, as the root user:

install -vDm755 target/release/awww        -t /usr/bin/ &&
install -vDm755 target/release/awww-daemon -t /usr/bin/ &&
ln -sfv awww        /usr/bin/swww &&
ln -sfv awww-daemon /usr/bin/swww-daemon

If you wish to install shell completions, execute the relevant commands for your shell(s) as the root user:

install -vDm644 completions/awww.bash /usr/share/bash-completion/completions/awww
install -vDm644 completions/_awww -t /usr/share/zsh/site-functions/
install -vDm644 completions/awww.fish -t /usr/share/fish/vendor_completions.d/

If you built the man pages, install them as the root user:

install -vDm644 doc/generated/* -t /usr/share/man/man1/

Command Explanations

--features=avif: Use this switch if you want to be able to display AVIF images (requires dav1d).

Contents

Installed Programs: awww, awww-daemon, swww (link to awww), and swww-daemon (link to swww-daemon)
Installed Libraries: None
Installed Directories: None

Short Descriptions

awww

is the control tool for awww-daemon

awww-daemon

is the backend for the Answer to your Wayland Wallpaper Woes

swww

points to awww for backwards-compatibility

swww-daemon

points to awww-daemon for backwards-compatibility