这个项目能做什么

SpotMenu 将 Spotify 和 Apple Music 的播放控制直接带到 macOS 菜单栏。它使用 Swift 和 SwiftUI 构建,提供极简、原生的用户体验,让您在不中断工作流程的情况下管理音乐播放。 ### 主要功能 - **菜单栏集成**:直接在菜单栏中显示当前艺术家和歌曲标题。 - **播放控制**:悬停覆盖层提供播放、暂停、跳过和曲目点赞功能,并附带专辑封面。 - **键盘快捷键**:提供全局热键,可在系统任意位置控制播放。 - **曲目点赞**:特别针对 Spotify,用户可以使用 Spotify Web API 点赞或取消点赞曲目。 - **紧凑视图**:在全屏和紧凑显示模式之间切换,以节省菜单栏空间。 - **实时更新**:应用自动同步活动媒体播放的变化。 - **多播放器支持**:自动检测活动播放器,或允许在 Spotify 和 Apple Music 之间手动选择。 ### 安装 用户可以通过多种方式安装 SpotMenu: - **直接下载**:从 GitHub Releases 页面获取最新的签名并公证的 `.app.zip`,其中包含通过 Sparkle 的自动更新功能。 - **Homebrew**:使用命令 `brew install --cask spotmenu` 轻松安装。 - **从源码构建**:需要 macOS 13+(Ventura)和 Xcode 15+。克隆仓库并打开 `SpotMenu.xcodeproj`。 ### Spotify 开发者设置 要启用曲目点赞功能,用户必须在 Spotify Developer Dashboard 上创建应用程序,将重定向 URI 配置为 `com.github.kmikiy.spotmenu://callback`,并将生成的客户端 ID 输入到 SpotMenu 的偏好设置中。 ### 自定义和偏好设置 该应用在“偏好设置”菜单下提供广泛的自定义选项: - **音乐播放器选择**:在自动检测、Spotify 或 Apple Music 之间选择。 - **外观控制**:调整悬停色调颜色、前景颜色、模糊强度和播放覆盖层的透明度。 - **菜单栏视觉效果**:切换艺术家名称、歌曲标题、图标的可见性,并调整最大宽度(40–300pt)。 - **快捷键映射**:设置播放/暂停、上一首/下一首曲目以及点赞/取消点赞操作的全局热键。 ### 使用指南 - **左键单击**:显示或隐藏播放面板。 - **右键单击**:打开上下文菜单。 - **悬停在面板上**:显示详细的播放控制。 SpotMenu 根据 MIT 许可证发布。