feat(theme): hard-cut hyprpaper and make control center realtime

Remove hyprpaper from runtime/provisioning and switch wallpaper orchestration to quickshell+wpgtk with stateful fallback, while applying appearance changes instantly without Apply/Save/Revert staging.

Made-with: Cursor

Author: ulises-jeremias

README.md

@@ -164,7 +164,7 @@ dots rice list              # See all available themes
 🐾 **[Kitty](https://sw.kovidgoyal.net/kitty)** — GPU-accelerated terminal emulator  
 🐚 **[Zsh](https://zsh.org) + [Powerlevel10k](https://github.com/romkatv/powerlevel10k)** — Feature-rich shell with beautiful prompt  
 🔒 **[Hyprlock](https://github.com/hyprwm/hyprlock)** — Secure lock screen  
-🖼️ **[Hyprpaper](https://github.com/hyprwm/hyprpaper)** — Fast wallpaper daemon  
+🖼️ **Quickshell + wpgtk wallpaper flow** — Unified wallpaper management via `dots-wallpaper-set`  
 🎨 **Rice System** — Instant theme switching with Material Design 3 colors
 
 > 📖 [Complete component list →](https://github.com/ulises-jeremias/dotfiles/wiki/Home)

docs/Quickshell-Hard-Cut-Matrix.md

@@ -9,7 +9,7 @@ It defines what stays, what is removed, and why.
 - `home/dot_local/bin/executable_dots-appearance`
 - `home/dot_local/bin/executable_dots-color-scheme`
 - `home/dot_local/bin/executable_dots-smart-colors`
-- `home/dot_local/bin/executable_dots-hyprpaper-set`
+- `home/dot_local/bin/executable_dots-wallpaper-set`
 - `home/dot_local/bin/executable_dots-wal-reload`
 - `home/dot_local/bin/executable_dots-settings-gui`
 - `home/dot_local/bin/executable_dots-launcher` (Quickshell-first, minimal rescue)
@@ -43,7 +43,7 @@ It defines what stays, what is removed, and why.
 
 Core install should represent Quickshell + Hyprland only:
 
-- Keep: `hyprland`, `quickshell`, `hyprpaper`, `hyprlock`, `hypridle`, `cliphist`, `wl-clipboard`, `copyq`, core media/network/system packages.
+- Keep: `hyprland`, `quickshell`, `hyprlock`, `hypridle`, `cliphist`, `wl-clipboard`, `copyq`, core media/network/system packages.
 - Remove from core defaults: `mako`, `wofi`, `nwg-bar`, `nwg-drawer`, `wlogout`, and other legacy menu/widget stack assumptions.
 
 ## Call-Site Cleanup Requirement

docs/System-Architecture.md

@@ -16,7 +16,7 @@
 
 - Quickshell (M3 color scheme via scheme.json)
 - Hyprland (compositor animations and settings)
-- Wallpaper system (hyprpaper)
+- Wallpaper system (Quickshell background + wpgtk contract)
 - GTK themes (automatic light/dark selection)
 
 **Design Constraints:**

docs/wiki/Dots-Scripts.md

@@ -100,14 +100,14 @@ dots smart-colors --concept=error
 dots wal-reload
 ```
 
-### hyprpaper-set
+### wallpaper-set
 
-- Sets wallpaper through Hyprpaper IPC
-- Persists wallpaper state
-- Triggers smart-colors regeneration and Quickshell palette reload (unless invoked from an outer theme pipeline)
+- Unified wallpaper entrypoint used by Quickshell and scripts
+- Delegates to `wpg -s` when available
+- Fallback path writes wallpaper state files and triggers smart-colors + Quickshell palette reload
 
 ```bash
-dots hyprpaper-set /path/to/wallpaper.jpg
+dots wallpaper-set /path/to/wallpaper.jpg
 ```
 
 ## Notes

docs/wiki/Home.md

@@ -52,7 +52,7 @@ Most were written from scratch. Core stack:
 - **Terminal Emulator** 🐾 [Kitty](https://sw.kovidgoyal.net/kitty/) - GPU-accelerated terminal
 - **Shell** 🐚 [Zsh](https://zsh.org) with Powerlevel10k prompt
 - **Lockscreen** 🔒 [Hyprlock](https://github.com/hyprwm/hyprlock) - Secure lock screen
-- **Wallpaper** 🖼️ [Hyprpaper](https://github.com/hyprwm/hyprpaper) - Fast wallpaper daemon
+- **Wallpaper** 🖼️ Quickshell + wpgtk integration via `dots-wallpaper-set`
 - **File Manager** 🃏 [Thunar](https://docs.xfce.org/xfce/thunar/start) with customized side pane
 - and many more!
 

docs/wiki/Smart-Colors-System.md

@@ -5,15 +5,15 @@ Smart Colors generates semantic colors and Material Design 3 palettes from the c
 ## Primary Contract
 
 - Quickshell is the main consumer through `~/.cache/dots/smart-colors/scheme.json`.
-- `dots-wal-reload` and `dots-hyprpaper-set` trigger palette refresh and Quickshell IPC reload.
+- `dots-wal-reload` and `dots-wallpaper-set` trigger palette refresh and Quickshell IPC reload.
 - Script consumers can source shell/env exports from the same cache directory.
 
 ## Wallpaper Pipeline Contract
 
 ### Historical pipelines
 
-- **wpgtk pipeline**: `wpg -s <image>` -> `wpg.conf` runs `dots-wal-reload` -> `dots-hyprpaper-set` updates runtime wallpaper state.
-- **Quickshell direct pipeline**: UI actions used to call `dots-hyprpaper-set` directly, bypassing `wpg` and global reload orchestration.
+- **wpgtk pipeline**: `wpg -s <image>` -> `wpg.conf` runs `dots-wal-reload` and refreshes shell colors.
+- **Legacy Quickshell direct pipeline**: UI actions used to call compositor-specific wallpaper setters directly, bypassing `wpg` and global reload orchestration.
 
 The direct pipeline could desynchronize `~/.config/wpg/.current` from shell/runtime state and miss some app reloads that are centralized in `dots-wal-reload`.
 

home/.chezmoiscripts/linux/run_onchange_before_install-hyprland.sh.tmpl

@@ -30,8 +30,7 @@ yay -S --noconfirm --needed \
 
 # Wallpaper management
 yay -S --noconfirm --needed \
-  swaybg \
-  hyprpaper
+  swaybg
 
 # Clipboard manager
 yay -S --noconfirm --needed \

home/dot_config/hypr/hyprland.conf.d/autostart.conf

@@ -54,9 +54,6 @@ exec-once = ~/.local/bin/dots-battery-monitor -d
 # Load Xresources (for XWayland apps)
 exec-once = xrdb -merge ~/.Xresources
 
-# Wallpaper daemon
-exec-once = hyprpaper
-
 # Cursor theme
 exec-once = hyprctl setcursor elementary 24
 

home/dot_config/hypr/hyprpaper.conf.tmpl

@@ -25,43 +25,12 @@ Item {
         root: root
     }
 
-    readonly property bool hasPendingChanges: Config.hasPendingChanges || session.hasPendingActions
-
     function close(): void {
     }
 
-    function applyChanges(): void {
-        session.applyPendingActions();
-        Schemes.reload();
-        Appearances.reload();
-        Wallpapers.stopPreview();
-        Colours.showPreview = false;
-    }
-
-    function saveChanges(): void {
-        session.applyPendingActions();
-        Config.writeNow();
-        Schemes.reload();
-        Appearances.reload();
-        Wallpapers.stopPreview();
-        Colours.showPreview = false;
-    }
-
-    function revertChanges(): void {
-        session.clearPendingActions();
-        Config.revertChanges();
-        Schemes.reload();
-        Appearances.reload();
-        Wallpapers.stopPreview();
-        Colours.showPreview = false;
-    }
-
     implicitWidth: implicitHeight * Config.controlCenter.sizes.ratio
     implicitHeight: screen.height * Config.controlCenter.sizes.heightMult
 
-    Component.onCompleted: Config.beginEditSession()
-    Component.onDestruction: Config.endEditSession()
-
     GridLayout {
         anchors.fill: parent
 
@@ -128,50 +97,5 @@ Item {
         }
     }
 
-    StyledRect {
-        id: actionBar
-        z: 20
-
-        anchors.right: parent.right
-        anchors.bottom: parent.bottom
-        anchors.rightMargin: Appearance.padding.large
-        anchors.bottomMargin: Appearance.padding.large
-
-        color: Colours.tPalette.m3surfaceContainerHigh
-        radius: Appearance.rounding.full
-        visible: true
-        opacity: root.hasPendingChanges ? 1 : 0.9
-
-        implicitHeight: actionsRow.implicitHeight + Appearance.padding.small * 2
-        implicitWidth: actionsRow.implicitWidth + Appearance.padding.small * 2
-
-        RowLayout {
-            id: actionsRow
-            anchors.centerIn: parent
-            spacing: Appearance.spacing.small
-
-            TextButton {
-                type: TextButton.Tonal
-                text: qsTr("Apply")
-                enabled: root.hasPendingChanges
-                onClicked: root.applyChanges()
-            }
-
-            TextButton {
-                type: TextButton.Filled
-                text: qsTr("Save")
-                enabled: root.hasPendingChanges
-                onClicked: root.saveChanges()
-            }
-
-            TextButton {
-                type: TextButton.Text
-                text: qsTr("Revert")
-                enabled: root.hasPendingChanges
-                onClicked: root.revertChanges()
-            }
-        }
-    }
-
     readonly property bool initialOpeningComplete: panes.initialOpeningComplete
 }