clawtunes
/install clawtunes
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 +10orclawtunes volume -10 - Mute:
clawtunes mute - Unmute:
clawtunes unmute
Shuffle and Repeat
- Enable/disable shuffle:
clawtunes shuffle onorclawtunes shuffle off - Set repeat mode:
clawtunes repeat off,clawtunes repeat all, orclawtunes 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.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install clawtunes - 安装完成后,直接呼叫该 Skill 的名称或使用
/clawtunes触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
clawtunes 是什么?
Control Apple Music on macOS via the `clawtunes` CLI (play songs/albums/playlists, control playback, volume, shuffle, repeat, search, catalog lookup, AirPlay... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2403 次。
如何安装 clawtunes?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install clawtunes」即可一键安装,无需额外配置。
clawtunes 是免费的吗?
是的,clawtunes 完全免费(开源免费),可自由下载、安装和使用。
clawtunes 支持哪些平台?
clawtunes 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin)。
谁开发了 clawtunes?
由 forketyfork(@forketyfork)开发并维护,当前版本 v0.3.1。