aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--desktop/companion/README.md8
-rw-r--r--docs/superpowers/specs/2026-10-23-companion-blush-design.md5
2 files changed, 11 insertions, 2 deletions
diff --git a/desktop/companion/README.md b/desktop/companion/README.md
index adbcb01..4bb87f2 100644
--- a/desktop/companion/README.md
+++ b/desktop/companion/README.md
@@ -12,6 +12,8 @@ The design, with what was measured on the way, is
| `Figure.qml` | draws a frame: crossfade, bob, drop out and back, explosion |
| `Mood.js` | which state wins, from a snapshot; all the timings are its `T` |
| `Lines.js` | her lines and the opening monologue |
+| `Admired.qml` | the wallpaper list she blushes at, and what wallp has on each monitor |
+| `ListFile.js` | that list as plain text: parse and toggle |
| `prep-frames` | generated images to display frames |
| `gen-frames`, `frames.txt` | the generated images, through sd-server |
@@ -56,6 +58,12 @@ frame falls back to its outfit's `base`.
only when the class changes, a third of the time, under the 30 s line
cooldown. Lines are `app:<class>` in `Lines.js`, class lowercased; a
class with none says nothing.
+- A listed wallpaper (Settings > Desktop > Companion for the file, the
+ heart in the wallpaper picker for entries) on an empty workspace: she
+ turns to it with `watch` and blushes with `blush3`, at most every 3
+ minutes. Checked on `workspacev2` and `closewindow`, and whenever she
+ stops being away. Her monitor's wallpaper comes from wallp's
+ `wallp.conf` outputs and `wall_h`/`wall_v`.
- She only feels the pointer while it is over her: Quickshell has no
global pointer and Hyprland sends no motion events. Hence the 0.6 s
dodge rather than moving away as the pointer approaches.
diff --git a/docs/superpowers/specs/2026-10-23-companion-blush-design.md b/docs/superpowers/specs/2026-10-23-companion-blush-design.md
index 06d2370..a52b29e 100644
--- a/docs/superpowers/specs/2026-10-23-companion-blush-design.md
+++ b/docs/superpowers/specs/2026-10-23-companion-blush-design.md
@@ -11,8 +11,9 @@ Checked at two moments, in `Companion.qml`:
- the focused workspace changes or loses a window (`workspacev2`,
`closewindow`), so switching to an empty workspace or closing its last
window counts;
-- she appears: shown (SUPER+\ or the settings switch), back from a remap
- after another layer opened, or moved to another monitor with the focus.
+- she stops being away: shown (SUPER+\ or the settings switch), back
+ from a remap after another layer opened, moved to another monitor with
+ the focus, back from a dodge, or out of fullscreen.
It fires when all three hold: