Skip to content
Automation
Skill

/now

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.

From plugin
media
416 skills1 hook
Install
$ npx -y skills add Bangs00/claude-media-control --skill now --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/now

Context preview

The summary Claude sees to decide when to auto-load this skill.

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.

SKILL.md

now.SKILL.md
name: now
description: 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.
allowed-tools: Bash

Current system-wide now-playing state (JSON):

!`"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" now`

The progress bar, already rendered (empty when the bar is switched off, when nothing is playing, or when the track has no duration):

!`"${CLAUDE_PLUGIN_ROOT}/scripts/media.sh" bar`

Present the state to the user exactly in this format, as plain markdown lines — NOT inside a code block, so the bold/italic styling renders:

  • Line 1: `▶︎ **<title>** — *<artist>* · <appName>` — use `▶︎` when `playing` is true, `⏸` when false; title bold, artist italic. If `appName` is missing, use `bundleIdentifier`.
  • Line 2 (only when the bar above is non-empty): the bar copied **verbatim**, then two spaces and `**m:ss** / m:ss` (elapsed time bold). Never redraw the bar, re-space it, change its width, or substitute its characters — `media.sh bar` is the same builder that draws the statusline segment, and copying it byte-for-byte is what keeps the two surfaces agreeing. Most presets cannot be reproduced by hand anyway: they are computed waveforms whose glyphs depend on the playback position.
  • The elapsed `m:ss` is ALWAYS `elapsedTimeNow` (use `elapsedTime` only when `elapsedTimeNow` is absent) — `elapsedTime` is the app's last snapshot and can lag minutes behind; the statusline segment shows `elapsedTimeNow`, so anything else here would contradict it. The total `m:ss` is `duration`.
  • If `duration` is absent (live stream): the bar comes back empty; show `**m:ss** / LIVE` (same elapsed rule).
  • If the JSON is `null`: tell the user nothing is playing right now.
  • If the JSON contains `"degraded": true` or a stderr hint appeared: add one short note that the plugin is in fallback mode and `/media:doctor` has details.

Example (the markdown you output):

▶︎ **Neon Horizon** — *Midnight Arcade* · Firefox
━━━━━━━━━━━─────────  **2:07** / 3:48
Read more
Ships withmedia

The current track, live in your Claude Code statusline — ticking every second, ⌘+clickable, styleable down to the bar characters: And whatever your Mac is playing — Spotify, Apple Music, a browser tab, VLC — you can control it from the chat too: "what song is

Get the whole plugin
Stats
4
Stars
0
Forks
Maintained
Maintenance
Shell
Language
MIT
License
2mo ago
Last commit
2mo ago
Created

Repo: Bangs00/claude-media-control

Other skills on media.

verify
Skill

verify

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…

@bangs00@bangs00View Skill
artwork
Skill

artwork

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.

@bangs00@bangs00View Skill
config
Skill

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…

@bangs00@bangs00View Skill
doctor
Skill

doctor

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

@bangs00@bangs00View Skill
history
Skill

history

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…

@bangs00@bangs00View Skill
menu
Skill

menu

Interactive media remote — control playback via a selectable menu (toggle, next, previous, seek, volume, artwork). Use when the user asks for a media remote,…

@bangs00@bangs00View Skill