Protocol overview

Crownpaper exposes one service, crownpaper, on the brokerless crownos-ipc bus. The socket lives at $XDG_RUNTIME_DIR/crownos/crownpaper.sock, and peers are authenticated by the kernel when they connect.

Add the client#

The library crate holds only the protocol, so clients skip the daemon's graphics stack.

[dependencies]
crownpaper = { git = "https://github.com/Crown-OS/crownpaper", default-features = false }

let mut client = crownpaper::Client::connect()?;
let pending = client.set("/home/you/Pictures/dunes.webp".into(), 0.8)?;
client.wait(pending, Some(Duration::from_secs(5)))?;

Message kinds#

Stability#

From 1.0 the protocol follows semantic versioning. Every method has a selector hashed from its name and full signature, so a mismatched client gets an UNKNOWN_METHOD error instead of misdecoded data.