← Back to Skills Marketplace
Clawtunes Play
by
S K Aravind
· GitHub ↗
· v1.0.3
· MIT-0
84
Downloads
1
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install clawtunes-play
Description
Play Apple Music songs on macOS using clawtunes, including streaming catalog tracks via a practical keyboard-navigation workaround after opening the song in...
README (SKILL.md)
Clawtunes Play
Use clawtunes as the first choice for Apple Music control on this Mac.
Workflow
- For library items, try direct playback first.
- For songs likely not in the library, search the Apple Music catalog and open the selected result in Music.
- For catalog playback, prefer the wrapper script that tries the best-known keyboard sequence automatically:
Tab+Tab+Enter- fallback:
Tab+Enter - fallback:
Shift-Tab+Enter
- Check whether playback actually changed to the requested song.
- If playback did not switch, say so plainly.
Commands
- Direct library-style play:
clawtunes_play --song "\x3Csong>"
- Catalog play wrapper:
catalog_play "\x3Cquery>"
- Status only:
clawtunes_play --status
- Experimental step-by-step catalog workflow:
catalog_play_experiment "\x3Cquery>" --index 1 --strategy tab-tab-enter
Requirements
This skill assumes these local tools are available on macOS:
clawtunespython3osascriptopen
It also needs macOS Accessibility / Automation permission so System Events can send keyboard input to Music.
Install / Use
- Keep repo in
skills/clawtunes-play - Commands:
clawtunes_play,catalog_play,catalog_play_experiment - For catalog playback, use the wrapper script in
scripts/catalog_play_wrapper.sh
Notes
clawtunes play songtargets library playback.clawtunes catalog searchopens the streaming result in Music, but Music may not autoplay unless the UI focus lands correctly.- The current best-known workaround is keyboard navigation after opening the result.
- This is macOS UI-state dependent; it is usable, but not a guaranteed Apple primitive.
Usage Guidance
This skill appears to do what it says: it searches Apple Music (itunes.apple.com), opens tracks in the Music app, and simulates keyboard input via AppleScript/System Events. Before installing, verify you trust the source (homepage unknown), confirm you have or want to grant macOS Accessibility/Automation permission (this allows simulated keypresses), and ensure the local 'clawtunes' utility is legitimate. You can test safely by running the included scripts manually from a shell to observe their behavior (they print JSON results). If you are uncomfortable with autonomous invocation, avoid enabling the skill to run without your explicit prompt. Finally, review the scripts yourself to confirm no local modifications were made to target processes beyond Music.
Capability Analysis
Type: OpenClaw Skill
Name: clawtunes-play
Version: 1.0.3
The skill utilizes high-risk capabilities including UI automation via `osascript` and `System Events` to inject keystrokes (e.g., Tab, Enter, Cmd+L) into the macOS Music app, which requires Accessibility permissions. It also performs network requests to the iTunes API (`itunes.apple.com`) and executes shell commands via `subprocess` to interact with the `clawtunes` CLI. While these actions are aligned with the stated purpose of automating Apple Music playback and catalog navigation, the use of keystroke simulation and shell execution represents a significant privilege level and attack surface. Key files: `catalog_play.py`, `playlist_create.py`, and `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description match the implementation: scripts call clawtunes, osascript, and open to control the Music app, and they query the iTunes Search API to find catalog tracks—these are all necessary for the described functionality.
Instruction Scope
SKILL.md describes the exact local commands and macOS permissions the scripts use. The runtime instructions and scripts only access the Music app, local utilities (clawtunes, osascript, open, python3), and the iTunes search endpoint; they do not read unrelated files or environment variables.
Install Mechanism
No install spec or remote download is used; the skill is distributed as code included in the bundle. It runs local Python scripts and a small wrapper shell script—no external package downloads or archive extraction were observed.
Credentials
The skill requests no environment variables or credentials. It does use macOS Accessibility/Automation permissions (necessary for sending keyboard events) and network access to itunes.apple.com for search results—both are proportionate to the stated purpose.
Persistence & Privilege
The skill uses default invocation settings (not always:true). It can be invoked autonomously per platform defaults; this is normal but be aware it will run local commands and send keyboard events when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clawtunes-play - After installation, invoke the skill by name or use
/clawtunes-play - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Add install notes and requirements
v1.0.2
Add requirements and install notes for macOS music control
v1.0.1
Make paths portable and update usage docs
v1.0.0
Clarify Mac Apple Music app support and catalog search/play
Metadata
Frequently Asked Questions
What is Clawtunes Play?
Play Apple Music songs on macOS using clawtunes, including streaming catalog tracks via a practical keyboard-navigation workaround after opening the song in... It is an AI Agent Skill for Claude Code / OpenClaw, with 84 downloads so far.
How do I install Clawtunes Play?
Run "/install clawtunes-play" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Clawtunes Play free?
Yes, Clawtunes Play is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Clawtunes Play support?
Clawtunes Play is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Clawtunes Play?
It is built and maintained by S K Aravind (@skaravind); the current version is v1.0.3.
More Skills