managing-apple-music

name	managing-apple-music
description	Control Apple Music on macOS via the `clawtunes` CLI (play songs/albums/playlists, control playback, volume, shuffle, repeat, search, catalog lookup, AirPlay, and playlist management). 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	{"clawdbot":{"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 playlists, manage shuffle/repeat, browse the Apple Music catalog, 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"
• Always use the --non-interactive (-N) flag to prevent interactive prompts: clawtunes -N play song "Song Name"
• If the command exits with code 1 and lists multiple matches, retry with a more specific song/album/playlist name.
• If a more specific name still returns multiple matches, use the --first (-1) flag to auto-select the first result: clawtunes -1 play song "Song Name"

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
• Create a playlist: clawtunes playlist create "Road Trip"
• Add a song to a playlist: clawtunes playlist add "Road Trip" "Kickstart My Heart"
• Remove a song from a playlist: clawtunes playlist remove "Road Trip" "Kickstart My Heart"

AirPlay

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

Apple Music Catalog

• Search the streaming catalog: clawtunes catalog search "Bowie Heroes"
• Limit catalog results: clawtunes catalog search "Bowie Heroes" -n 5
• Note: Catalog search is browse-only. To add songs to playlists, they must first be in your library. Use Apple Music app to add catalog items to your library before managing them with clawtunes.

Notes

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