wallpapers

Search folders for images and sets the background image at a regular interval. Images are selected randomly from the full list of images found.

It serves two purposes:

• adding support for random images to any background setting tool
• quickly testing different tools with a minimal effort

It allows "zapping" current backgrounds, clearing it to go distraction free and optionally make them different for each screen.

Minimal example (uses swaybg by default):

[wallpapers]
path = "/home/fab/Images/wallpapers/" # path to the folder with background images
unique = true # set a different wallpaper for each screen

More complex, using swww as a backend (not recommended because of its stability):

[wallpapers]
path = "/home/fab/Images/wallpapers/"
interval = 60 # change every hour
extensions = ["jpg", "jpeg"]
recurse = true
# Using swww
command = "swww img --transition-type any \"[file]\""
clear_command = "swww clear"

Note that for applications like swww, you'll need to start a daemon separately (eg: from hyprland.conf).

Added in version 2.2.0, format changed in 2.2.5

Commands

• wall next: Changes the current background image
• wall clear: Removes the current background image

Configuration

path

path to a folder or list of folders that will be searched. Can also be a list, eg:

path = ["/home/fab/Images/Portraits/", "/home/fab/Images/Landscapes/"]

interval (optional)

defaults to 10

How long (in minutes) a background should stay in place

command (optional)

Overrides the default command to set the background image.

Variables are replaced with the appropriate values, you must use a "[file]" placeholder for the image path. eg:

swaybg -m fill -i "[file]"

clear_command (optional)

By default clear command kills the command program.

Instead of that, you can provide a command to clear the background. eg:

clear_command = "swaybg clear"

extensions (optional)

defaults to ["png", "jpg", "jpeg"]

List of valid wallpaper image extensions.

recurse (optional)

defaults to false

When enabled, will also search sub-directories recursively.

unique (optional)

Added in 2.2.5

defaults to false

When enabled, will set a different wallpaper for each screen.

If you are not using the default application, ensure you are using "[output]" in the command template.

Example for swaybg: swaybg -o [output] -m fill -i "[file]"