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, 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.