Mac Media Key Forwarder：媒体键转发

项目简介

Mac Media Key Forwarder 是一个运行在 macOS 菜单栏的小工具，把键盘上的媒体键（播放/暂停、上一首、下一首）直接转发给 Apple Music、Spotify、Cider、Spotifast 和 Pear Desktop（YouTube Music）。

你可以指定优先控制哪一个播放器，也可以使用默认行为——把按键发给当前正在运行的播放器。项目使用 Swift 编写，采用 Unlicense 许可证。

主要功能

• 把播放/暂停、下一首/上一首等媒体键转发给多个受支持的播放器。
• 可为播放器设置优先级，或使用默认的“跟随当前运行播放器”行为。
• 状态栏菜单提供快捷控制：暂停转发，以及当前优先播放器的控制。
• 设置窗口（⌘,）中包含开机启动、隐藏菜单栏图标、自动暂停和 Cider API Token 等选项。
• “Launch player hidden”：优先播放器未运行时按下媒体键会启动它，可选择隐藏启动（类似 ⌘H），再接收按键，从而不打断当前工作。
• 各播放器的控制方式不同：Apple Music 与 Spotify 通过 AppleScript（Scripting Bridge）控制；Cider 通过本地 REST API（http://localhost:10767）；Spotifast 通过其私有本地 socket；Pear 通过本地 HTTP API（http://localhost:26538）。

安装与使用

从项目的 Releases 页面下载编译好的应用。

应用需要两项权限：

• 辅助功能（Accessibility）：用于监听键盘媒体键。
• 自动化（Automation）：用于向 Apple Music 和 Spotify 发送播放、暂停、切歌指令，首次使用媒体键时 macOS 会弹出 osascript 授权提示。

首次启动时应用会请求辅助功能权限，并提供 Open System Settings 按钮。在“隐私与安全性”>“辅助功能”中打开 MacMediaKeyForwarder 后即刻开始转发，无需重启应用。

Cider：在 Cider 的 Settings > Connectivity 中启用 RPC 服务器；如果 Cider 要求外部应用令牌，在 Mac Media Key Forwarder 的 Settings… > Players 中填入。

Spotifast：无需配置，保持 Spotifast 0.12.0 或更高版本运行即可。

Pear Desktop（YouTube Music）：在 Pear 的 Plugins 中启用 API Server 插件，并保持默认端口 26538；第一次按媒体键时在 Pear 中允许 “MacMediaKeyForwarder”，令牌会被保存复用。

注意事项

• 应用通过事件 tap 监听按键，个别场景可能受影响，例如在 Safari 偏好设置窗口切换搜索引擎、或允许第三方内核扩展时；此时可从菜单中暂停 Mac Media Key Forwarder。
• 当前版本要求 macOS 26（Tahoe）或更高，应用已使用 Developer ID 签名并通过 Apple 公证；更旧的系统请使用 3.1.2 版本。
• Cider、Spotifast 和 Pear 不会被 Mac Media Key Forwarder 自动启动。

---

本作品整理自 GitHub 开源项目 quentinlesceller/macmediakeyforwarder，原作者 @quentinlesceller，许可证 Unlicense。中文介绍由 AI 根据项目 README 整理，以原仓库为准。