-
Notifications
You must be signed in to change notification settings - Fork 6
Desktop environments
github-actions[bot] edited this page Sep 3, 2026
·
1 revision
GNOME, KDE and XFCE manage their own wallpaper, so greyline drives them through a shell command.
The same page ships with greyline and always matches your installed version:
greyline help desktopsDesktop environments — GNOME, KDE and XFCE set the wallpaper themselves, so
greyline drives them through the `command` backend: a shell command run once
per output with {path} (the rendered PNG) and {output} substituted.
`greyline init` detects these and writes the matching recipe for you. To set one
by hand:
greyline config set backend command
greyline config set command '<recipe below>'
gnome:
gsettings set org.gnome.desktop.background picture-uri "" && gsettings set org.gnome.desktop.background picture-uri "file://{path}" && gsettings set org.gnome.desktop.background picture-uri-dark "file://{path}"
kde:
plasma-apply-wallpaperimage {path}
xfce:
xfconf-query -c xfce4-desktop -p /backdrop/screen0/monitor0/workspace0/last-image -s {path}
These are best-effort and community-verified — the XFCE monitor segment in
particular varies by version and output name; find yours with:
xfconf-query -c xfce4-desktop -l | grep last-image
Another desktop? Any command that sets a wallpaper from a file works. Please
open a desktop-compat issue with what worked for you.
greyline is not a live-wallpaper engine and not an overlay. It renders a PNG and
sets it as the desktop wallpaper through the desktop's own tool, so you do not
need swww or any wallpaper daemon on GNOME. The last image stays after greyline
stops.
The recipes above are best-effort and community-verified: the maintainer runs sway and cannot test them directly. If yours needs a tweak, please open a desktop-compatibility issue.