← Back to Skills Marketplace
Apple Music Play
by
S K Aravind
· GitHub ↗
· v2.0.0
· MIT-0
124
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install apple-music-play
Description
Play Apple Music songs on macOS using clawtunes with keyboard navigation to stream catalog tracks via the Music app and local library.
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 uses clawtunes, the Apple iTunes Search API, opens music:// URLs, and automates the Music app with osascript/System Events. Before installing, ensure you: (1) trust the source of the skill and the clawtunes binary (this code executes local commands), (2) are comfortable granting macOS Accessibility/Automation permission (this allows sending keystrokes to the Music app and could interact with other UI if focus changes), (3) verify network access to itunes.apple.com is acceptable (the scripts query the iTunes Search API), and (4) review the included scripts locally (they are small, readable Python scripts) if you have concerns. If you do not trust the repository owner or clawtunes, don’t grant Accessibility permissions or install/run the scripts.
Capability Analysis
Type: OpenClaw Skill
Name: apple-music-play
Version: 2.0.0
The skill provides macOS Apple Music control, specifically implementing a workaround for playing streaming catalog tracks using AppleScript and System Events to automate UI keystrokes (Tab, Enter). The scripts (catalog_play.py, playlist_create.py) interact with the legitimate iTunes Search API (itunes.apple.com) and local tools like clawtunes and osascript. The behavior is transparently documented in SKILL.md and INSTALL.md, and the code uses safe subprocess execution patterns to prevent shell injection.
Capability Assessment
Purpose & Capability
Name/description (Apple Music playback via clawtunes and UI automation) align with what the files do: use clawtunes for library/catalog actions, call the iTunes Search API, open music:// URLs, and drive Music via osascript/System Events.
Instruction Scope
SKILL.md explicitly instructs use of clawtunes, python3, osascript, and open and documents Accessibility/Automation permission. The runtime scripts do UI automation (send keystrokes) and call the Apple iTunes Search endpoint — these are within the claimed scope but require macOS Accessibility permission and can mis-target input if the UI focus changes.
Install Mechanism
No install spec; this is instruction-only with included scripts. Nothing downloads or extracts remote archives or installs third-party packages during install, so install risk is low.
Credentials
The skill requests no environment variables or credentials. It does need local tools (clawtunes, python3, osascript, open) and macOS Accessibility/Automation permission — these are proportional to its UI-automation purpose.
Persistence & Privilege
always is false, and the skill does not claim to modify other skills or global agent settings. Autonomous invocation is allowed by default but not coupled with elevated privileges or broad credential access.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install apple-music-play - After installation, invoke the skill by name or use
/apple-music-play - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
Rename for discoverability; keep Mac Apple Music + catalog play support
Metadata
Frequently Asked Questions
What is Apple Music Play?
Play Apple Music songs on macOS using clawtunes with keyboard navigation to stream catalog tracks via the Music app and local library. It is an AI Agent Skill for Claude Code / OpenClaw, with 124 downloads so far.
How do I install Apple Music Play?
Run "/install apple-music-play" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Apple Music Play free?
Yes, Apple Music Play is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Apple Music Play support?
Apple Music Play is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Apple Music Play?
It is built and maintained by S K Aravind (@skaravind); the current version is v2.0.0.
More Skills