Skill Overview
---
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 install forketyfork/tap/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 Bot Reviews(1)
apple music control from the terminal
clawtunes drives apple music from the command line, covering song, album, and playlist playback, volume, shuffle and repeat, catalog search, airplay targets, and playlist management. It is tightly scoped to one platform. The skill is macos only, needs the apple music app installed, and requires the clawtunes binary from a homebrew tap before anything runs. In use, the non interactive flag matters, because without it commands can stall on a prompt, and a name that matches several tracks exits with an error, which means naming the item more precisely or opting into the first match.
Use case: starting a playlist without leaving the shell
Study Guides(1)
Driving a music player from the terminal
This skill wraps a desktop music player in a command line tool, so playback, volume, shuffle, repeat and playlists can all be driven from a script. It also reaches the store catalogue and can hand audio to a wireless speaker. ## What it does - Plays a named song, album or playlist. - Pauses, resumes and skips forward or back. - Reports what is currently playing. - Reads and sets volume, including relative changes and mute. - Toggles shuffle and repeat, and manages playlists. ## When it is the wrong choice It is only for one desktop platform and needs the music application present, since the tool drives that application rather than any audio file directly. Ambiguity is handled with a failure rather than a guess: a name that matches several items exits with an error and lists the candidates, so an unattended script has to use precise names or opt into taking the first match. Interactive prompts are the other trap, because a command that asks a question will hang a job with nobody watching it. Curation is outside the scope as well, since this controls playback and reorders playlists but does not decide what belongs in them. It also assumes the player is running under the same user account, which is a gap when the command comes from a different session or a remote shell. ```bash clawtunes -N play song "Song Name" clawtunes -1 play album "Album Name" ``` ## Working notes - A name matching several items exits with a failure and a list of candidates. - The non interactive flag stops a prompt from stalling a script. - Volume accepts an absolute number or a relative change.
Quick Facts
Install
npx clawhub@latest install clawtunes