feat(island): a media pill left of the clock

Shows album art and a scrolling "artist · album · title" while a
player is playing or paused, using the sound module's Player so the
browser proxy duplicates are already filtered. Hovering swaps the text
for a progress bar, swapped in place rather than growing the pill;
MPRIS does not push position, so it is re-read every second while
hovered, and a click seeks only when the player reports canSeek and a
known length. The wheel steps tracks one per notch, as the layout flag
does, so a touchpad does not skip several.

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

1 files changed, 12 insertions, 1 deletions

diff --git a/desktop/island/README.md b/desktop/island/README.md
index c202e61..1511279 100644
--- a/desktop/island/README.md
+++ b/desktop/island/README.md
@@ -1,7 +1,8 @@
 # island
 
 A thin neutral bar at the top centre of `DP-1`. Point at it and two pills
-slide out of it: a clock pill on the left and a status pill on the right. It
+slide out of it: a clock pill on the left and a status pill on the right,
+with a media pill left of the clock while something plays or is paused. It
 replaced waybar, both bars. It is not a separate shell: `desktop/shell.qml`
 instantiates it next to the drawer, so it starts with `qs -p ./desktop` and
 shares the drawer's IPC and keepalive window.
@@ -60,6 +61,16 @@ used to open from here is the drawer's Performance page now
   `activelayout` event. Scroll switches layout with
   `hyprctl switchxkblayout current next|prev`.
 
+## Media pill
+
+Left of the clock pill, while something is playing or paused. It shows the album art and `artist · album · title`, scrolling when the
+line is wider than 220px. The player is the sound module's `Player`, so the
+browser proxy duplicates are already filtered out. Hovering swaps the text for a
+progress bar; MPRIS does not push position, so the pill re-reads it every
+second while hovered. A click on the bar seeks, only when the player reports
+`canSeek` and a known length. The wheel over the pill goes to the previous track (up)
+or the next (down), one per notch.
+
 ## Controls panel (removed)
 
 There was one, opened by SUPER alone. Each of its seven tiles opened a drawer