Skill: forketyfork/clawtunes (version 0.3.1)

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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)