Apple Music终端控制

技能简介

clawtunes 是一款 macOS 专用的命令行工具，通过 AppleScript 与 Apple Music 应用通信，让用户在终端中完成搜索、播放、音量调节、播放列表管理及 AirPlay 设备切换等操作。

能做什么

• 搜索并播放歌曲、专辑、播放列表
• 控制播放暂停、切歌、查看当前播放状态
• 调节音量、静音/取消静音
• 设置随机播放和循环模式
• 创建和管理播放列表，添加或移除歌曲
• 浏览 Apple Music 流媒体曲库
• 连接和切换 AirPlay 输出设备
• 标记喜欢或不喜欢的曲目

使用说明

安装步骤

1. 确保系统为 macOS，且已安装 Apple Music 应用
2. 通过 Homebrew 安装：brew install forketyfork/tap/clawtunes
3. 首次运行时若提示自动化权限，前往「系统设置 > 隐私与安全性 > 自动化」授予权限

基础用法

• 播放歌曲（非交互模式）：clawtunes -N play song "歌曲名"
• 如遇多结果冲突，加 --first 自动选首项：clawtunes -1 play song "歌曲名"
• 暂停/继续：clawtunes pause / clawtunes resume
• 设置音量：clawtunes volume 50 或 clawtunes volume +10
• 搜索曲库：clawtunes search "关键词"
• 列出 AirPlay 设备并连接：clawtunes airplay 后 clawtunes airplay "设备名"

输入与输出

见下方输入与输出表格。

风险提示

• 仅限 macOS 系统，Windows/Linux 无法使用
• 依赖 Apple Music 应用运行，若应用未启动可能指令失败
• 流媒体曲库搜索结果仅支持浏览，添加到播放列表需先入库
• 部分操作需用户手动授权自动化权限

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/forketyfork/clawtunes/SKILL.md
来源类型：GitHub 仓库