quickshell/modules/wallpaper/Wallpaper.qml

import QtQuick
import Quickshell
import Quickshell.Wayland
import "."

WlrLayershell {
    id: root

    // 1. Send it to the bottom of the stack!
    layer: WlrLayer.Background

    // 2. Stretch it to cover the ENTIRE screen
    anchors {
        top: true
        bottom: true
        left: true
        right: true
    }

    // 3. IMPORTANT: Tell the compositor NOT to reserve space for this.
    // If you don't do this, your wallpaper might push your windows aside!
    exclusionMode: ExclusionMode.Ignore

    // 4. The actual content

    Image {
        id: actualWall
        anchors.fill: parent
        source: WallpaperStore.currentWall
        fillMode: Image.PreserveAspectCrop

        Behavior on source {
            NumberAnimation {
                duration: 500
            }
        }
        onSourceChanged: console.log("🖼️ Wallpaper noticed change! New source: " + source)
    }

    // Bonus: A dark rectangle to dim the wallpaper slightly?
    Rectangle {
        anchors.fill: parent
        color: "black"
        opacity: 0.2
    }
}