名称： 管理-apple-music
描述： 通过 clawtunes CLI 控制 macOS 上的 Apple Music（播放歌曲/专辑/播放列表，控制播放、音量、随机播放、重复、搜索、目录查找、AirPlay 和播放列表管理）。当用户要求播放音乐、搜索歌曲、控制音频播放或管理 Apple Music 设置时使用。
主页： https://github.com/forketyfork/clawtunes
元数据： {"clawdbot":{"emoji":"🎵","os":["darwin"],"requires":{"bins":["clawtunes"]},"install":[{"id":"brew","kind":"brew","tap":"forketyfork/tap","formula":"clawtunes","bins":["clawtunes"],"label":"通过 Homebrew 安装 clawtunes"}]}}

Apple Music 命令行工具

使用 clawtunes 从终端控制 Apple Music。你可以搜索和播放音乐、控制播放、调整音量、管理播放列表、设置随机/重复模式、浏览 Apple Music 目录以及连接 AirPlay 设备。

安装设置

• 安装 (Homebrew)：brew install forketyfork/tap/clawtunes
• 系统要求：仅限 macOS；需要 Apple Music 应用程序。

播放音乐

• 播放歌曲：clawtunes play song "歌曲名"
• 播放专辑：clawtunes play album "专辑名"
• 播放播放列表：clawtunes play playlist "播放列表名"
• 使用 --non-interactive (-N) 标志：始终添加此标志以避免交互式提示，例如：clawtunes -N play song "歌曲名"
• 处理多个匹配项：如果命令以代码 1 退出并列出多个匹配项，请尝试使用更具体的歌曲/专辑/播放列表名称重试。
• 自动选择第一项：如果更具体的名称仍返回多个匹配项，可使用 --first (-1) 标志自动选择第一个结果：clawtunes -1 play song "歌曲名"

播放控制

• 暂停：clawtunes pause
• 恢复播放：clawtunes resume
• 下一曲：clawtunes next
• 上一曲：clawtunes prev
• 显示当前播放：clawtunes status

音量控制

• 显示音量：clawtunes volume
• 设置音量：clawtunes volume 50
• 调整音量：clawtunes volume +10 或 clawtunes volume -10
• 静音：clawtunes mute
• 取消静音：clawtunes unmute

随机播放与重复模式

• 启用/禁用随机播放：clawtunes shuffle on 或 clawtunes shuffle off
• 设置重复模式：clawtunes repeat off、clawtunes repeat all 或 clawtunes repeat one

搜索

• 搜索歌曲和专辑：clawtunes search "查询词"
• 包含播放列表：clawtunes search "查询词" -p
• 仅搜索歌曲：clawtunes search "查询词" --no-albums
• 限制结果数量：clawtunes search "查询词" -n 20

喜爱/不喜爱

• 喜爱当前曲目：clawtunes love
• 不喜爱当前曲目：clawtunes dislike

播放列表管理

• 列出所有播放列表：clawtunes playlists
• 创建播放列表：clawtunes playlist create "播放列表名"
• 向播放列表添加歌曲：clawtunes playlist add "播放列表名" "歌曲名"
• 从播放列表移除歌曲：clawtunes playlist remove "播放列表名" "歌曲名"

AirPlay

• 列出设备：clawtunes airplay
• 选择设备：clawtunes airplay "设备名"
• 取消选择设备：clawtunes airplay "设备名" --off

Apple Music 目录

• 搜索流媒体目录：clawtunes catalog search "查询词"
• 限制目录搜索结果：clawtunes catalog search "查询词" -n 5
• 重要提示：目录搜索仅供浏览。若要将歌曲添加到播放列表，必须先将其添加到你的资料库。请使用 Apple Music 应用程序将目录项目添加到资料库，然后再使用 clawtunes 进行管理。

注意事项

• 仅限 macOS：本工具使用 AppleScript 与 Apple Music 通信。
• 自动化权限：如果系统请求自动化权限，请在“系统设置”>“隐私与安全性”>“自动化”中授予访问权限。