Config
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.)From its SKILL.md
npx -y skills add Bangs00/claude-media-control --skill configAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
6.2 KB, as published. Nobody here has run it
Requested change (may be empty): $ARGUMENTS
Current settings:
!"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config
Pick the mode from $ARGUMENTS:
Mode A — a key was given ($ARGUMENTS is NOT empty)
The user named a specific key (e.g. display.statusline on,
statusline.marquee off). Apply it directly and report the result:
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config $ARGUMENTS
Valid keys:
display.progressbar— progress bar in the/media:nowreplydisplay.statusline— the statusline now-playing segmentstatusline.multiline— layout:on= each group on its own line,off= one line (unused whenstatusline.fieldshas/breaks)statusline.color— ANSI colors/bold/italic in the statusline (defaulton; theNO_COLORenv var also disables it)statusline.marquee— scroll statusline titles wider than 30 cells, one char/second (defaulton)statusline.links— which parts of the statusline segment are cmd+clickable, each switchable on its own (defaulton= all four):toggle(the ▶︎/⏸ icon toggles playback),track(title/artist jump to the playing media — the playing browser tab or Music's current track when the app is scriptable, plain app activation otherwise),app(the same jump from the app name), andseek(each progress-bar cell seeks). Takeson(all),off(none), or a comma/space list of parts —config statusline.links toggle,seekleaves the text plain and keeps the icon and bar clickable. Any part left on builds + registers the localclaude-media-control://handler app, and is refused (exit 3) when that build fails; parts switched off render exactly as they would with links off. Works in hyperlink-capable terminals (iTerm2, Ghostty, WezTerm, Kitty, VS Code)history.record— log played tracks to the local history (defaulton; view with/media:history)statusline.fields— which items the statusline shows, as an ordered comma/space list oftrack app volume progressbar time outputwith optional/line breaks (interactive:/media:statusline)style.<part>— per-item statusline styles (15 string-valued keys;config stylelists them, the valueresetrestores one,config style resetrestores all). Guided styling lives in/media:statusline.statusline reset— restore the whole statusline appearance to defaults: arrangement, explicit lines, colors, marquee, and everystyle.*key. Does not touchdisplay.statuslineor the non-statusline toggles.
Rules you must follow:
- Enabling runs a preflight. Exit code 3 means the feature cannot work right now and the
enable was refused (fail-closed by design). Explain the reason from stderr, point to
/media:doctor, and do NOT retry or work around the refusal. - Enabling
display.statuslinealso wires the segment into~/.claude/settings.jsonautomatically (wrapper + backup of the previousstatusLine; details indocs/statusline.md). Relay the wiring line the command prints — it says whether it wired, refreshed, or found a manual setup it left alone. The segment shows up on the next statusline tick, no restart needed. - A wish to unwire the statusline (remove it from settings.json, "배선
해제", "settings에서 빼줘") maps to
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" statusline uninstall— it restores the backed-upstatusLine, removes the wrapper + backup, and turnsdisplay.statuslineoff. (Plaindisplay.statusline offonly hides the segment and keeps the wiring for a fast re-enable. Uninstalling the plugin reverts the wiring by itself.) - Disabling always succeeds.
- Afterwards show the resulting state (re-run
configwith no key if helpful).
Mode B — no key given ($ARGUMENTS is empty) → quick settings
Ask ONE AskUserQuestion call with exactly ONE question (single-select, header "Settings"): "Which setting do you want to change?" — exactly these four options, with the CURRENT value from the settings table above baked into each label so the user sees the state before picking:
Statusline: <on|off>— description: the now-playing segment rendered into Claude Code's statusline (enabling wires it intosettings.jsonautomatically and it appears on the next tick); selecting flips it./media:now progress bar: <on|off>— description: the progress bar drawn under the/media:nowreply; selecting flips it.Playback history: <on|off>— description: passively log played tracks (view with/media:history); selecting flips it.Reset statusline settings— description: restore the statusline's default look — arrangement, lines, colors, marquee, and all per-item styles. The three toggles above are not touched.
Then apply the selection with one Bash call:
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config display.statusline on # option 1 (flip)
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config display.progressbar on # option 2 (flip)
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config history.record on # option 3 (flip)
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config statusline reset # option 4
If enabling display.statusline is refused (exit 3), no now-playing read
path works right now; relay the stderr reason and point to /media:doctor —
fail-closed by design, never bypass it. An "Other" answer names a key or a
wish — map it onto Mode A (arrangement or styling wishes belong to
/media:statusline; run that flow instead of guessing keys here).
Show the result
"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" config
Report the changed key (old → new) in one line. After a reset, mention the
statusline is back to its stock look. Close with one pointer: arranging items
and lines, and styling any part (colors, bold/italic, bar characters, icons)
live in /media:statusline.