Next: , Previous: , Up: API  


1.21 (heks-linux wallpaper)

1.21.1 Parameters

Parameter: wallpaper-script-dir

Default value:

"/root/.local/bin"
Parameter: wallpaper-script-filename

Default value:

"user-script-set-random-wallpaper"
Parameter: wallpaper-service-filename

Default value:

"random-wallpaper.service"
Parameter: wallpaper-systemd-dir

Default value:

"/root/.config/systemd/user"
Parameter: wallpaper-timer-filename

Default value:

"random-wallpaper.timer"

1.21.2 Procedures

Procedure: install-wallpaper-config

Write the wallpaper script and its systemd user units to their directories. Local overrides are read from $XDG_CONFIG_HOME/heks-linux/wallpaper-settings.scm first. Restart the timer with systemctl --user restart random-wallpaper.timer after changing the wallpaper list.

Procedure: mk-random-wall-cmd walls

Render the shell script that picks a random wallpaper. walls is the list of wallpaper paths. The script selects from that list using the current day modulo the number of wallpapers, so a machine shows a stable image for the whole day rather than changing on every invocation.

Procedure: wallpapers

Return active wallpaper absolute file paths based on the running theme palette.