| 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. Use when this capability is needed. |
| metadata | {"author":"demerzels-lab"} |
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.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
