Waypaper EngineA wallpaper setter GUI, built for ricing

Gallery, playlists, multiple backends supported on wayland and x11, SSE events, multiple themes and fonts, written in typescript and go.

Install & run

🖼️

Beautiful Gallery

Import images, videos, and HTML wallpapers. Thumbnails at multiple sizes, folders, tags, color swatches, and Wallhaven built in.

🔁

Playlists just like Wallpaper Engine

Timer, manual, time-of-day, and day-of-week schedules—all run in the daemon with clear events you can react to.

🧩

Multiple backends to choose from

awww (transitions, Wayland), hyprpaper, swaybg, feh (X11), mpvpaper (video), or wal-qt for HTML/video wallpapers. Auto mode picks the right one per media type.

🔌

Integrate with anything

The same JSON API the UI uses is open to scripts and tools. Subscribe to GET /events with Server-Sent Events—filter by type or tail from the CLI.

🎨

Theme & font presets

Ships with a long list of DaisyUI themes and font presets (including a "neo" gallery look). Pick in Settings or wire your own CSS stack.

🎬

Looper and Shader Studio (Beta)

Looper Studio for in/out points on video, and Shader Studio for importing Shadertoy JSON and saving WebGL wallpapers into the gallery.

Try it

~ / install

$yay -S waypaper-engine
$systemctl --user enable --now waypaper-daemon
$waypaper-engine

Installs the daemon, GUI, .desktop file, and systemd user unit.