什么是clawtunes
clawtunes 是一款专为 macOS 用户设计的命令行工具，通过终端即可实现对 Apple Music 应用程序的远程控制。它利用 AppleScript 与系统内建的 Apple Music 应用进行通信，让用户无需打开图形界面，就能在终端中完成音乐播放、搜索、播放列表管理等一系列操作。该工具完全基于命令行交互，非常适合习惯使用终端或需要自动化音乐控制的用户场景。
作为 Apple Music 的官方客户端扩展，clawtunes 支持播放本地库中的歌曲、专辑和播放列表，同时也提供了对 Apple Music 流媒体目录的浏览功能。虽然无法直接添加流媒体内容到播放列表（需先在 Apple Music 应用中将其加入个人曲库），但这一限制并不影响其在日常音乐管理和自动化流程中的实用性。此外，工具还支持音量调节、静音切换、随机播放与循环模式设置等基础播放控制功能。
值得一提的是，clawtunes 特别强调非交互式操作，默认要求用户使用 `-N` 或 `–non-interactive` 参数来避免因名称模糊导致的确认提示。当搜索结果存在多个匹配项时，可通过 `-1` 参数自动选择首个结果，提升脚本执行效率。整体设计围绕自动化与批量处理优化，是开发者、播客制作者或追求高效工作流的技术用户的理想选择。
核心功能特点
- 支持播放本地曲库中的歌曲、专辑和播放列表
- 提供完整的播放控制：暂停、恢复、上一首/下一首、当前状态查询
- 可精确调节音量（设定具体值或增减百分比）并支持一键静音/取消静音
- 灵活管理随机播放与重复模式（关闭、单曲循环、全部循环）
- 强大的搜索功能，涵盖歌曲、专辑及可选包含播放列表
- 支持创建和管理自定义播放列表，包括添加或移除指定曲目
适用场景
clawtunes 特别适合需要在终端环境中集成音乐控制的场景，例如自动化脚本中嵌入背景音乐播放、远程服务器通过 SSH 控制家庭娱乐系统播放特定歌单，或在开发过程中根据代码提交信息自动切换不同情绪的背景音乐。对于经常使用 Apple Music 且偏好命令行操作的高级用户而言，它显著提升了音乐管理的效率，避免了频繁切换窗口的操作负担。
在媒体制作或播客录制场景中，创作者可以通过简单的命令快速调用“专注工作”或“放松聆听”等预设播放列表，确保工作流程不被中断。同时，结合 cron 任务或 shell 脚本，还能实现定时播放功能，比如早晨通勤时段自动启动晨间音乐。对于技术爱好者来说，将 clawtunes 集成进智能家居自动化平台（如 Home Assistant）也极具可行性，实现语音指令触发音乐播放。
尽管 clawtunes 不支持直接添加流媒体内容到播放列表，但其对本地曲库的完整操控能力使其成为个人音乐库管理的高效工具。无论是整理大量收藏的歌曲、构建个性化播放列表，还是为特定活动定制音乐氛围，都能通过简洁的命令行指令快速完成。配合 AirPlay 设备支持，还可轻松将音乐投射至客厅音响或其他兼容设备，拓展了其在家庭娱乐系统中的实际应用场景。