forketyfork

clawtunes

Design & Mediav0.3.1
By forketyforkUpdated 2026-05-113 versions · latest released 2026-02-19@clawhub_forketyfork/clawtunes
Audio#Music

According to AlphaMoat, as of 2026-09, clawtunes has 3,483 downloads and 3 stars — ranked #3,175 of 5,078 AI skills overall, and #296 of 512 in Design & Media.

Installs
115
Downloads
3.5K
Stars
3
Overall Rank
#3,175
Top 63% overall · Top 58% in Design & Media
PlatformInstallsDownloadsStarsComments
ClawHub ↗1153.5K3-
SkillHub ↗1143.5K3—

Platforms count differently and update at different times.

What this skill does

The clawtunes CLI can play music, search songs and albums, adjust volume, manage playlists and playback settings, browse the Apple Music catalog, and select AirPlay devices. Catalog search is browse-only; a song must already be in your library before it can be added to a playlist. Installation requires trusting a third-party Homebrew tap, and automation may require macOS permission.

Profile published 2026-10-29

What you can do with it

  • Play songs, albums, or playlists
  • Search tracks and browse the Apple Music catalog
  • Control volume, shuffle, repeat, and AirPlay

When to use it

  • When using Apple Music on macOS
  • When you want to control playback or playlists from a terminal or agent

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Find a song in Apple Music and play it; ask me before choosing if there are multiple matches.
Explain the clawtunes installation source and required macOS Automation permission before controlling playback.

Monthly Trend

Downloads3.5K
2.3K2.9K3.6K2026-03 · Downloads 2.3K2026-05 · Downloads 2.8K2026-06 · Downloads 3.0K2026-07 · Downloads 3.2K2026-08 · Downloads 3.4K2026-09 · Downloads 3.5K26-0326-09
Stars3
2342026-03 · Stars 32026-05 · Stars 32026-06 · Stars 32026-07 · Stars 32026-08 · Stars 32026-09 · Stars 326-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-093.5K—3
2026-083.4K+3.9%3
2026-073.2K+8.3%3
2026-063.0K+5.3%3
2026-052.8K—3
2026-032.3K—3

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

3.4 KB · ClawHub v0.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.
Show all (82 lines)

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.

Popular in Design & Media

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.