Waemon

Wayland wallpaper daemon.

Installation

Archlinux User Repository: waemon-git

Configuration

On startup configuration is read from one of (in order):

• ./waemon.jsonc
• ${XDG_CONFIG_HOME}/waemon.jsonc
• ~/.config/waemon.jsonc
• /etc/waemon.jsonc

{
    "groups": {
        // Group names are used when sending commands over IPC

        "main": {
            "outputs": ["DP-3", "DP-2"],    // list of output names
            "backgroundColor": "#ffffff",   // (optional) hex color string like #123 or #abcdef
            "wallpaper": "/path/to/image",  // (optional) absolute path to image
            "mode": "zoom"                  // (optional) center | zoom | stretch | tile | contain
        },

        "secondary": {
            "outputs": ["HDMI-1"],
            "backgroundColor": "#0f0"
        },
    }
}

Socket protocol

Waemon tries to bind to $XDG_RUNTIME_DIR/waemon.sock. You can send commands to it using:

print '["status"]' | socat "UNIX-CONNECT:/run/user/$UID/waemon.sock"  - | jq

Get current status

Request

["status"]

Response

{
    "status": "ok",
    "groups": {
        "main": {
            "backgroundColor": "#ffffff",
            "wallpaper": "/path/to/image",
            "mode": "zoom",
            "total_w": 2560,
            "total_h": 1400,
            "matchedOutputs": [
                {
                    "name": "DP-2",
                    "x": 0,
                    "y": 0,
                    "w": 2560,
                    "h": 1440
                }
            ]
        },
    }
}

Update group config

Request

[
    "update", "<groupName>", {
        "backgroundColor": "#ffffff",
        "wallpaper": "/path/to/image",
        "mode": "zoom",
    }
]

(any subset of keys are valid, like in the config file)

Response

{"status": "ok"}

Errors

If anything goes wrong the daemon will reply with

{"status": "error", "error": "womp womp"}

Todo

• static output group definitions (jsonc)
• fixup WallpaperImage error handling and add cache
• dynamic wallpaper and spantype changes over DBus or normal socket (json messages)
• split into daemon and cli
• Come up with a new name (was paper)
• package for arch