companion: music frames to generate, and the README

Twelve frames, dress and leotard. Prompts are a first draft for klein; the
user generates them, and until then each falls back to base.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 12 insertions, 1 deletions

diff --git a/desktop/companion/README.md b/desktop/companion/README.md
index 37aab16..4fbe887 100644
--- a/desktop/companion/README.md
+++ b/desktop/companion/README.md
@@ -11,7 +11,7 @@ The design, with what was measured on the way, is
 | `Companion.qml` | the window, inputs, timers, speech, IPC (`companion toggle/show/hide`) |
 | `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 reaction and per-app lines, and the opening monologue |
+| `Lines.js` | her reaction, per-app and per-artist 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 |
@@ -77,6 +77,17 @@ frame falls back to its outfit's `base`.
   sings once for `Mood.T.singHold`, 4 s, and says a line if the usual 30 s
   cooldown allows it. A shell start with them already on is not a connection:
   Bluetooth reads empty for ~2 s, then populates.
+- What is playing is `modules/sound/Player.qml`, which already drops the
+  playerctld and browser-integration duplicates. A new artist+title while
+  playing makes her DJ for `Mood.T.djHold`, 6 s (`dj` and `dj-scratch`
+  cycling), and say the artist's line if one matches: lowercased keys in
+  `Lines.artists`, matched as a substring, edited on Settings > Companion
+  artists into `Prefs.companionArtists`. Pause and resume of the same
+  track is not a change; a shell start with music on DJs once. While
+  music plays, the first idle stage is a groove instead of bored:
+  `whistle`, `headbang` (`headbang-up`/`-down` cycling) or `airguitar`,
+  picked at random, with a `groove` line; yawning and lying down are
+  unchanged.
 - 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.