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): INLINECODE1
• macOS-only; requires Apple Music app.

Play Music

• - Play a song: INLINECODE2
• Play an album: INLINECODE3
• Play a playlist: INLINECODE4
• Always use the --non-interactive (-N) flag to prevent interactive prompts: INLINECODE7
• 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: INLINECODE10

Playback Control

• - Pause: INLINECODE11
• Resume: INLINECODE12
• Next track: INLINECODE13
• Previous track: INLINECODE14
• Show now playing: INLINECODE15

Volume

• - Show volume: INLINECODE16
• Set volume: INLINECODE17
• Adjust volume: clawtunes volume +10 or INLINECODE19
• Mute: INLINECODE20
• Unmute: INLINECODE21

Shuffle and Repeat

• - Enable/disable shuffle: clawtunes shuffle on or INLINECODE23
• Set repeat mode: clawtunes repeat off, clawtunes repeat all, or INLINECODE26

Search

• - Search songs and albums: INLINECODE27
• Include playlists: INLINECODE28
• Songs only: INLINECODE29
• Limit results: INLINECODE30

Love/Dislike

• - Love current track: INLINECODE31
• Dislike current track: INLINECODE32

Playlists

• - List all playlists: INLINECODE33
• Create a playlist: INLINECODE34
• Add a song to a playlist: INLINECODE35
• Remove a song from a playlist: INLINECODE36

AirPlay

• - List devices: INLINECODE37
• Select device: INLINECODE38
• Deselect device: INLINECODE39

Apple Music Catalog

• - Search the streaming catalog: INLINECODE40
• Limit catalog results: INLINECODE41
• 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.