← Back to Skills Marketplace

clawtunes

Name: clawtunes
Author: forketyfork

by forketyfork · GitHub ↗ · v0.3.1

darwin ✓ Security Clean

2403

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install clawtunes

Description

Control Apple Music on macOS via the `clawtunes` CLI (play songs/albums/playlists, control playback, volume, shuffle, repeat, search, catalog lookup, AirPlay...

README (SKILL.md)

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

Usage Guidance

This skill is coherent for controlling Apple Music via the clawtunes CLI. Before installing, verify you trust the Homebrew tap (forketyfork/tap) and review its formula/source on the project GitHub to ensure it matches the published code. Expect macOS Automation permission prompts (System Settings > Privacy & Security > Automation) so the CLI can control Apple Music; grant only if you trust the binary. Because this skill executes a locally-installed binary, avoid installing it from untrusted taps or running unfamiliar versions. Otherwise the skill's requirements and instructions align with its stated purpose.

Capability Analysis

Type: OpenClaw Skill Name: clawtunes Version: 0.3.1 The skill bundle is benign. It clearly defines its purpose as controlling Apple Music on macOS using the `clawtunes` CLI. Installation is handled via Homebrew, a standard package manager, and all instructions for the AI agent are directly related to using `clawtunes` for music control (play, pause, volume, search, playlists). There is no evidence of prompt injection attempts, data exfiltration, persistence mechanisms, obfuscation, or any other malicious intent within the skill's instructions or metadata. The reliance on an external binary (`clawtunes`) is transparent and aligned with the skill's stated functionality.

Capability Assessment

✓ Purpose & Capability

Name/description match the required binary and actions. All declared requirements (macOS, clawtunes binary, Apple Music app) are appropriate for controlling Apple Music from the terminal.

✓ Instruction Scope

SKILL.md directs only CLI operations using clawtunes (playback, search, playlists, AirPlay) and briefly notes macOS automation permissions. It does not instruct reading unrelated files, environment variables, or exfiltrating data to external endpoints.

ℹ Install Mechanism

Install uses Homebrew with a third‑party tap (forketyfork/tap) and formula 'clawtunes'. This is expected for an external CLI but third‑party taps can install arbitrary code — verify the tap/formula and source (GitHub repo) before installing.

✓ Credentials

No environment variables, credentials, or config paths are requested. The absence of secrets is proportionate to the skill's stated purpose.

✓ Persistence & Privilege

Skill is not 'always: true' and does not request persistent system-wide changes. It may prompt for macOS Automation permission to control Apple Music (normal for this use-case). Agent autonomous invocation is enabled by default but is not unusual.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install clawtunes
After installation, invoke the skill by name or use /clawtunes
Provide required inputs per the skill's parameter spec and get structured output

Version History

v0.3.1

Clarified installation instructions: pip is not supported, brew is a one-liner.

v0.3.0

Added playlist management commands, Apple Music search, --non-interactive and --first flags

v0.1.0

Initial release of clawtunes Apple Music management skill. - Control Apple Music on macOS through the `clawtunes` CLI. - Play songs, albums, or playlists; interactive menu for multiple matches. - Manage playback (pause, resume, next/previous track, show status), volume (set, adjust, mute), shuffle, and repeat. - Search for music and playlists directly via command line. - Love or dislike tracks, list and manage playlists. - Connect to and control AirPlay audio devices. - Requires macOS and the Apple Music app; Homebrew and pip installation supported.

Metadata

Slug clawtunes

Version 0.3.1

License —

All-time Installs 3

Active Installs 3

Total Versions 3

Frequently Asked Questions

What is clawtunes?

Control Apple Music on macOS via the `clawtunes` CLI (play songs/albums/playlists, control playback, volume, shuffle, repeat, search, catalog lookup, AirPlay... It is an AI Agent Skill for Claude Code / OpenClaw, with 2403 downloads so far.

How do I install clawtunes?

Run "/install clawtunes" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is clawtunes free?

Yes, clawtunes is completely free (open-source). You can download, install and use it at no cost.

Which platforms does clawtunes support?

clawtunes is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin).

Who created clawtunes?

It is built and maintained by forketyfork (@forketyfork); the current version is v0.3.1.

More Skills