← back

fork/wpaperd

git clone https://git.julia.blue/fork/wpaperd

Danilo SpinellaRename animation to transitioneb0422c

main
6 folders9 files

files

.github/workflows/
cli/
daemon/
ipc/
man/
nix/
.gitignore47 B
CHANGELOG.md990 B
Cargo.lock55.8 KiB
Cargo.toml79 B
LICENSE.md34.1 KiB
README.md5.6 KiB
flake.lock1.0 KiB
flake.nix1.0 KiB
install.yml389 B

wpaperd

GitHub's release (latest by date) GitHub license GitHub Workflow Status

wpaperd is the modern wallpaper daemon for Wayland. It dynamically changes the current wallpaper, either after a certain amount of time or via a command-line interface. It uses OpenGL ES to render the images and have beautiful hardware-accelerated transitions, while being easy on resources.

Notice: wpaperd uses wayland protocols available on all wlroots based compositors (sway, hyprland, ...) and on KDE. Therefore it won't work on GNOME.

Features

Getting started

Dependencies

wpaperd is written in Rust and requires a working Cargo installation. It also depends on:

Build

To install wpaperd, clone the repository and build the project:

$ git clone https://github.com/danyspin97/wpaperd
$ cd wpaperd
$ cargo build --release

Generate the man pages by running scdoc:

$ scdoc < man/wpaperd-output.5.scd > man/wpaperd-output.5

Install

You can install both the daemon (wpaperd) and cli (wpaperctl) using rinstall:

$ rinstall --yes

To run wpaperd, run the daemon:

$ wpaperd

If you want to automatically run it at startup, add this line to your sway configuration (located in $HOME/.config/sway/config):

# Assuming it has been installed in ~/.local/bin/wpaperd
exec ~/.local/bin/wpaperd -d

Or in Hyprland:

exec-once=~/.local/bin/wpaperd -d

Image formats support

loading and dislaying images. Have a look on its documentation for the supported formats.

Cycling images

When path is set to a directory, you can cycle the images by running the commands next and previous using wpaperctl:

$ wpaperctl next
$ wpaperctl previous

When sorting is set to asceding and desceding, wpaperd will use the wallpaper name to calculate the next wallpaper accordingly. When sorting is set to random, it will store all the wallpapers shown in a queue, so that the commands next and previous can work as intended.

Wallpaper Configuration

The configuration file for wpaperd is located in XDG_CONFIG_HOME/wpaperd/config.toml (which defaults to ~/.config/wpaperd/config.toml). Each section represents a different output and can contain the following keys:

The section default will be used as base for the all the display configuration; the section any will be used for all the displays that are not explictly listed. This allows to have a flexible configuration without repeating any settings. wpaperd will check the configuration at startup and each time it changes and provide help when it is incorrect.

This is the simplest configuration:

[DP-3]
path = "/home/danyspin97/github_octupus.png"

[DP-4]
path = "/home/danyspin97/Wallpapers"
duration = "30m"

This is a more complex configuration:

[default]
duration = "30m"
mode = "center"
sorting = "ascending"

[any]
path = "/home/danyspin97/default_wallpaper.png"

[DP-3]
path = "/home/danyspin97/Wallpapers"

If you're running sway, you can look for the available outputs and their ID by running:

$ swaymsg -t get_outputs

On Hyprland you can run:

$ hyprctl monitors

License

wpaperd is licensed under the GPL-3.0+ license.