claude-media-control

Configure the now-playing statusline in one place — toggle items (volume, progress bar, time, output device), arrange which item sits on which line as a numeric pattern like 123/456, and style every part; bold/italic/color for the track title, artist, app, time, volume bar & percent, and output device name; playing/paused colors, bar characters, and bar length (cells) for the progress bar; the volume icon and bar shape; the output device icon; the value off hides any part. Use when the user wants to lay out, reorder, restyle, recolor, resize, hide, or redesign anything in the statusline — e.g. "make the title cyan", "title color

Quick media settings — turn the now-playing statusline, the /media:now progress bar, or the playback history on/off, or reset the statusline to its default look. `config <key> [on|off|value]` changes any key directly. Use when the user wants to enable, disable, or reset a media display feature. (Arranging and styling the statusline lives in /media:statusline.)

Show what's currently playing on this Mac (any app — Spotify, Apple Music, browsers). Use when the user asks what song/track/music is playing, who the artist is, or wants playback status.

How to verify media.sh changes end-to-end on a real Mac — isolated data dir, real native build, and a controllable fake now-playing app (no dependency on the user's music apps).

Show or switch the Mac's audio output device (built-in speakers, AirPods, external displays, DACs). Use when the user asks where sound is playing, which output device is active, or wants audio routed to a different device.

Show or set the Mac's system output volume (0-100). Use when the user asks how loud the volume is, wants it louder/quieter, sets a specific level, or asks to mute.

Interactive media remote — control playback via a selectable menu (toggle, next, previous, seek, volume, artwork). Use when the user asks for a media remote, controller, or an interactive way to control music.

Show recently played tracks (a passive local playback log). Use when the user asks what played earlier, what song was on before, recently played music, or to clear the playback history.

Show the album artwork (cover art) of the currently playing track. Use when the user asks to see the album art, cover image, or artwork of what's playing.

Skip to the next track in whatever app is playing on this Mac. Use when the user says next song, skip this track, or change the song.

Pause system-wide media playback on this Mac. Use when the user says pause, mute the song for a moment, or hold the music.

Start or resume system-wide media playback on this Mac. Use when the user says play the music, resume playback, or continue the song.

Go back to the previous track in whatever app is playing on this Mac. Use when the user says previous song, go back a track, or replay the last song.

Jump to a specific time position in the currently playing track. Use when the user wants to seek, jump to a timestamp, rewind, fast-forward, or go to a position like 1:30 or 90 seconds.

Toggle play/pause for whatever media is playing system-wide on this Mac. Use when the user says pause the music, stop the song, resume, unpause, or toggle playback.

Diagnose the media plugin — native build, read/control paths, fallbacks, permissions — and suggest fixes. Use when media commands fail, return nothing, or the user asks to troubleshoot media control.