Docs
esc
Crownpaper · GuidesIntroductionCrownpaper is the GPU wallpaper daemon for CrownOS and other Wayland desktops.
Crownpaper · GuidesQuickstartBuild Crownpaper, start the daemon and change your wallpaper from the command line.
Crownpaper · GuidesConfigurationChoose the startup wallpaper, tune transitions and control how much memory Crownpaper keeps.
Crownpaper · API ReferenceProtocol overviewTalk to the Crownpaper daemon over crownos-ipc with a typed Rust client.
Crownpaper · API ReferencesetTransition the desktop to a new wallpaper.
Crownpaper · API ReferencepreloadDecode wallpapers into the GPU cache so a later set is instant.
Crownpaper · API ReferencepingA round trip that proves the daemon is alive and has drained everything sent before it.
Crownpaper · API ReferenceChangedPushed to every subscriber with the wallpaper that is now on screen.
Download

Usage

Configuration

Choose the startup wallpaper, tune transitions and control how much memory Crownpaper keeps.

Crownpaper has no config file of its own. It reads the shared CrownOS appearance file and takes everything else as command-line flags.

Startup wallpaper

~/.config/crownos/appearance.ron
{
    wallpaper: "/home/you/.backgrounds/wallpaper.jpg",
}

--image on crownpaper daemon overrides this value for one session.

Transition length

Every set takes an optional duration in seconds. The daemon's default comes from --duration.

crownpaper set ~/Pictures/dunes.webp -d 2

Memory

The renderer and decoded images are released when nothing needs them. Hold them on purpose when you know a change is coming, such as in a wallpaper picker.

CommandEffect
crownpaper preload <paths>…Decode wallpapers into the cache for an instant set
crownpaper unload <paths>…Drop preloaded wallpapers
crownpaper preload-rendererKeep the GPU renderer warm
crownpaper unload-rendererLet the renderer be released at rest

Logging

Set RUST_LOG before starting the daemon. Press Ctrl C or run crownpaper quit to stop it.

RUST_LOG=crownpaper=debug crownpaper daemon