[Louis-CFM]

The Mac's Spotify pill (#246) comes to Linux, through MPRIS, and Mochi now dances to the music on Windows/Linux, by the Mac's rules. Windows has no music source yet, so nothing changes there (same code path, nothing ever reports a track).

Rust: src-tauri/src/spotify.rs (Linux only)

• A small MPRIS client for org.mpris.MediaPlayer2.spotify on the session bus, using dbus 0.9.12. It is already in Cargo.lock through keyring, so nothing new is downloaded. The only lock change is the new dependency line. Linux: global shortcuts on Wayland through the XDG GlobalShortcuts portal #367 adds dbus the same way.
• No polling. While the pill is declared, one thread blocks on the bus. It wakes only for PropertiesChanged, Seeked and NameOwnerChanged (Spotify starting or quitting). Undeclaring the pill sends that thread a ping so it leaves the bus at once. The blocking_pop_message timeout is one hour; it only bounds a lost wake-up.
• What it reads: track (id, title, artist(s), album, mpris:length, mpris:artUrl), PlaybackStatus, Position, Shuffle, LoopStatus and Volume. Titles and artists are cut like the Mac's shortTitle / shortArtist. Track ids become spotify:track:…, so ads are recognised.
• Position: it isn't signalled. Rust reads it when the status or the track changes and when the card shows (spotify_refresh). The page runs it on from positionAt, as position(at:) does on the Mac.
• Commands:
  • spotify_control: playPause / next / previous / seek / shuffle / repeat / volume. Seek uses SetPosition, or Seek on builds whose trackid isn't an object path. Shuffle, repeat and volume show at once, since Spotify doesn't always signal them.
  • spotify_open: Raise if it can. Otherwise it starts spotify from PATH, else the Flatpak com.spotify.Client, else the Snap. With none of them it opens https://www.spotify.com/download/linux/.
  • spotify_installed: for Settings.
• Covers: the CSP blocks remote images (img-src 'self' data: blob:), so Rust fetches the cover with reqwest and sends a data URL in a spotify-artwork event. Rules:
  • Only i.scdn.co, *.scdn.co, *.spotifycdn.com or a local file:// path are read. open.spotify.com/image/… is rewritten to the CDN.
  • No redirects, 3 MB cap, and the type is checked from the bytes.
  • The last 12 covers are cached.
  • Nothing is fetched while Coucou is paused.

Page

• Catalog: integration_spotify ("Spotify", #1DB954, service, "Integration"), connect none. A new support: "linux" sits next to "windows". It is declared in Settings → Integrations, which now lists only the pills this OS offers. When there is no Spotify to launch, the row says "Not installed", as on the Mac.
• Views (views/spotify.ts) are ported from SpotifyPill, MusicControlButton, SpotifyCardView and NowPlaying*, with the Mac's sizes and colours:
  • Pill: the existing pill look, with a mini Mochi that dances while Spotify plays. On hover, play/pause and next appear (20 px round buttons) and the title makes room for them.
  • Card, playing: 36 px cover, title with the green dot, artist · album, and the progress bar with elapsed and remaining time. Drag or click the bar to seek. Below are shuffle, previous, play/pause, next and repeat, then the volume slider (sends are coalesced to one every 120 ms).
  • Card, idle: "Not playing" or "Spotify not installed", with Open Spotify or Get Spotify, in the existing idle-card layout.
  • Card, timers: while the card is on screen and playing, the progress repaints twice a second. Otherwise nothing runs.
  • New SVG icons: play, pause, forward, backward, shuffle, repeat, a music note and the volume levels. Nothing that already ships was restyled.
• Strings: all of them are the Mac's and were already in strings.json ("Not playing", "Open Spotify", "Get Spotify", "{0} — open Spotify", "Volume {0}%", "Shuffle on"…). extra.json needed nothing new.
• The pill's name follows the track ("Advertisement" for ads), as syncTaskName does. When music starts, the hidden island opens to compact without the peek sound (musicReveal).

Dance

• BotEngine.setDancing / applyDance are ported exactly into mochi/engine.ts: 112 BPM sway, hop, tilt and squash around the bottom of the body, a 0.3 s fade in and 0.5 s fade out, and happy eyes in idle or finished.
• Where he dances (Mac rules):
  • The island's Mochi: in compact mode whenever music plays, in the idle, working, thinking, searching and finished states.
  • When expanded: only on the overview with the Spotify pill in front.
  • The Spotify pill's mini Mochi.
  • Mochi on the desktop: the island adds dancing to the snapshot it sends him.
• One deliberate difference: the desktop Mochi stays awake while dancing. Asleep he would bounce at 4 fps; the Mac lets him doze off mid-dance.

README

The Linux section now covers the Spotify pill. The "doesn't dance" line now says he dances to Spotify on Linux.

Tests

• Rust: cargo test -p coucou --lib gives 213 passed and 1 ignored (11 new). They cover:
  • MPRIS parsing from real dbus variants and from plain values, and the metadata order.
  • Position extrapolation, pause freezing and the cap at the track's end.
  • Track ids, title and artist cleaning, cover sources and image sniffing.
  • The JSON shape the page receives.
• End to end: dbus-run-session -- cargo test -p coucou --lib spotify -- --ignored passes. It runs the real listener against a fake Spotify on a private session bus:
  • the initial read;
  • PlayPause, then the PropertiesChanged that comes back and the position read again;
  • SetPosition, Shuffle and Volume;
  • Spotify quitting (NameOwnerChanged);
  • the thread really ending when the pill is undeclared.
• Node: npm test gives 345 passed (21 new). They cover:
  • the dance math and the engine's transform;
  • the island and desktop dance rules;
  • position, time format and volume thresholds;
  • the catalog's Linux-only filtering in both directions;
  • report handling: pill name, silent reveal, refresh on show;
  • the card and pill views, including their controls.
• Builds: npx tsc --noEmit is clean, and cargo build -p coucou has no warnings.

Not covered

• Not run against a real Spotify: no Spotify or display in the build environment. The MPRIS calls follow the spec and the fake service.
• Older Spotify builds: some report Position as 0, so the bar starts from 0 after a pause or seek made in Spotify itself.
• Windows: the Windows build wasn't compiled here. The new Rust code there is the four no-op commands.
• Credit: the Mac's Spotify pill is by @JhoanG956 (Mac: Spotify pill and a richer Apple Music card #246).

🤖 Generated with Claude Code

https://claude.ai/code/session_01LJm3SRL9k3gBPaVtfPhwcT

---

Generated by Claude Code