managing-apple-music – OpenClaw Skill

---

name: managing-apple-music description: Control Apple Music on macOS via the clawtunes CLI (play songs/albums/playlists, control playback, volume, shuffle, repeat, search, AirPlay). Use when a user asks to play music, search for songs, control audio playback, or manage Apple Music settings. homepage: https://github.com/forketyfork/clawtunes metadata: { "openclaw": { "emoji": "🎵", "os": ["darwin"], "requires": { "bins": ["clawtunes"] }, "install": [ { "id": "brew", "kind": "brew", "tap": "forketyfork/tap", "formula": "clawtunes", "bins": ["clawtunes"], "label": "Install clawtunes via Homebrew", }, ], }, }

Apple Music CLI

Use clawtunes to control Apple Music from the terminal. Search and play music, control playback, adjust volume, manage shuffle/repeat, and connect to AirPlay devices.

Setup

• Install (Homebrew): brew tap forketyfork/tap && brew install clawtunes
• Install (pip): pip install clawtunes
• macOS-only; requires Apple Music app.

Play Music

• Play a song: clawtunes play song "Song Name"
• Play an album: clawtunes play album "Album Name"
• Play a playlist: clawtunes play playlist "Playlist Name"
• When multiple matches exist, an interactive numbered menu appears for selection.

Playback Control

• Pause: clawtunes pause
• Resume: clawtunes resume
• Next track: clawtunes next
• Previous track: clawtunes prev
• Show now playing: clawtunes status

Volume

• Show volume: clawtunes volume
• Set volume: clawtunes volume 50
• Adjust volume: clawtunes volume +10 or clawtunes volume -10
• Mute: clawtunes mute
• Unmute: clawtunes unmute

Shuffle and Repeat

• Enable/disable shuffle: clawtunes shuffle on or clawtunes shuffle off
• Set repeat mode: clawtunes repeat off, clawtunes repeat all, or clawtunes repeat one

Search

• Search songs and albums: clawtunes search "query"
• Include playlists: clawtunes search "query" -p
• Songs only: clawtunes search "query" --no-albums
• Limit results: clawtunes search "query" -n 20

Love/Dislike

• Love current track: clawtunes love
• Dislike current track: clawtunes dislike

Playlists

• List all playlists: clawtunes playlists

AirPlay

• List devices: clawtunes airplay
• Select device: clawtunes airplay "Device Name"
• Deselect device: clawtunes airplay "Device Name" --off

Notes

• macOS-only (uses AppleScript to communicate with Apple Music).
• If automation permissions are requested, grant access in System Settings > Privacy & Security > Automation.