docs(appearance): document the Sunset, Idle and Icons tabs

Records the IPC verbs, the shared hyprsunset.conf format, the preserved
hypridle comments, and the preview mechanisms. The hardcoded icon theme in
udt, waybar and rofi is tracked as a TODO in those repos.

1 files changed, 27 insertions, 1 deletions

diff --git a/appearance/README.md b/appearance/README.md
index 2a39bd7..eb3c1f3 100644
--- a/appearance/README.md
+++ b/appearance/README.md
@@ -3,7 +3,7 @@
 Wallpapers and colour scheme in one drawer. `SUPER+Return` opens it on the
 Wallpaper tab; Tab switches tabs, Escape closes.
 
-    ┌─[ Wallpaper ]─[ Theme ]──────────────────────────┐
+    ┌─[ Wallpaper ]─[ Theme ]─[ Sunset ]─[ Idle ]─[ Icons ]──┐
     │  Set on [Horizontal] [Vertical]   261 wallpapers │
     │  ┌────┐ ┌────┐ ┌────┐ ┌────┐        ┌──┐ ┌─────┐ │
     │  │    │ │    │ │    │ │    │        │  │ │     │ │
@@ -26,6 +26,32 @@ be running for the keybind to work:
 Write that path out in full in the real config: `exec_cmd` has no shell to
 expand `~`. `ipc call appearance theme` opens the other tab.
 
+IPC verbs: `wallpaper`, `theme`, `sunset`, `idle`, `icons`.
+
+## Sunset
+
+A port of `hyprsunset-qt` (`~/Programming/GIT/sunset-qt`): profiles in
+`~/.config/hypr/hyprsunset.conf`, location in
+`~/.config/hyprsunset-qt/config`, sunrise/sunset from the same API and cache.
+Both apps read and write the identical file format, so either can edit it.
+
+## Idle
+
+Timeout and enabled only; the commands in `~/.config/hypr/hypridle.conf` are
+fixed. Everything before the first `listener` (the `general` block and the
+comments explaining the design) is preserved verbatim. A disabled listener is
+written commented out. Save restarts `hypridle`, which resets its timers.
+
+## Icons
+
+Switches the icon and cursor theme. Icon previews come from a GTK lookup per
+theme; cursor previews extract `left_ptr` from a hyprcursor `.hlc` with
+`unzip` or from an Xcursor theme with `xcur2png`, and hovering changes the real
+cursor. Applying writes `gsettings`, the Qt configs, and for cursors
+`environment.lua`; apps and a relogin are needed to see the rest. The theme
+name is still hardcoded in `unified-desktop-theme`, `waybar-theme-udt` and
+rofi, which is tracked as a follow-up in those repos.
+
 ## Wallpapers
 
 Clicking a thumbnail **stages** it rather than setting it, so both screens can