原生体验的 macOS 桌面客户端
完整网页功能 · 系统集成 · 开源自用
WebView 壳 · 媒体键 · 菜单栏托盘 · 迷你播放器
| 🎵 完整网页体验 | 加载 music.youtube.com，搜索、播放列表、歌词、登录等功能与浏览器一致 |
| 🖥️ macOS 原生集成 | 菜单栏托盘、全局快捷键、控制中心 Now Playing、无边框窗口拖拽 |
| 🎧 媒体控制 | 键盘媒体键、托盘菜单播放控制、迷你播放器窗口 |
| 🧩 小窗体验 | 紧凑迷你播放器、置顶切换、进度拖动、音量、点赞 / 点踩、多主题 |
| 🔐 会话持久化 | Google 登录状态本地保存，重启后保持登录 |
| 📦 轻量可构建 | Electron + TypeScript，一键打包 .dmg 安装包 |
| 类别 | 功能 |
|---|---|
| 播放 | 完整 YouTube Music 网页播放、歌词、队列 |
| 登录 | Google 账号登录，OAuth 弹窗，会话持久化 |
| 系统集成 | 媒体键、控制中心 / 锁屏 Now Playing（Media Session API） |
| 窗口 | 无边框标题栏、顶部拖拽区域、关闭后保留在托盘、左上原生风格后退 / 前进 / 刷新 |
| 托盘 | 播放 / 暂停 / 上一首 / 下一首、显示主窗口、退出 |
| 迷你播放器 | 小尺寸浮窗、置顶切换、可拖动进度条、音量滑杆、点赞 / 点踩、主题切换 |
| 快捷键 | Cmd+Shift+M 切换主窗口，Cmd+Shift+P 迷你播放器，Cmd+L 登录 |
| 打包 | electron-builder 生成 macOS .dmg |
git clone https://github.com/caseclose/YouTubeMusic-MacOS.git
cd YouTubeMusic-MacOS
npm install
npm run dev开启 DevTools（可选）：
YTM_DEVTOOLS=1 npm run devnpm run build # 编译
npm run dist:mac # 打包 macOS 安装程序 → release/安装到应用程序文件夹：
cp -R "release/mac-arm64/YouTube Music.app" /Applications/
xattr -cr "/Applications/YouTube Music.app"覆盖安装已有版本：
osascript -e 'quit app "YouTube Music"' || true
ditto "release/mac-arm64/YouTube Music.app" "/Applications/YouTube Music.app"
xattr -cr "/Applications/YouTube Music.app"按 Cmd+Shift+P 或在托盘菜单中选择 Toggle Mini Player 可打开 / 隐藏迷你播放器。
迷你播放器提供：
- 播放控制：上一首、播放 / 暂停、下一首
- 进度控制：拖动进度条跳转播放位置
- 音量控制：底部轻量音量滑杆
- 反馈控制：点赞 / 点踩当前播放内容
- 置顶切换：右上角图钉按钮可切换是否置于顶层
- 多主题：左上角调色板按钮循环切换主题
- 主题按钮隐藏：右键调色板按钮可隐藏 / 显示；隐藏后左上角仅保留很淡的 hover 热区
内置主题：
| 主题 | 风格 |
|---|---|
| 黑曜 | 默认深色玻璃质感 |
| 午夜蓝 | 冷色蓝黑氛围 |
| 暖橙 | 日落暖色调 |
| 森林绿 | 低饱和自然绿 |
| 霓虹 | 粉蓝赛博高光 |
| 极光 | 青紫渐变氛围 |
| 樱花 | 柔和粉色系 |
| 葡萄紫 | 深紫高光 |
| 拿铁 | 暖棕咖啡色 |
| 冰川 | 冷白蓝灰 |
主题选择和主题按钮隐藏状态会保存在本地，下次打开继续使用。
| 快捷键 | 功能 |
|---|---|
| 媒体键 播放/暂停 | 播放 / 暂停 |
| 媒体键 下一首 | 下一首 |
| 媒体键 上一首 | 上一首 |
Cmd+Shift+M |
显示 / 隐藏主窗口 |
Cmd+Shift+P |
切换迷你播放器 |
Cmd+L |
打开登录页 |
Electron 33 + electron-vite + TypeScript + electron-builder
↓
WebView (music.youtube.com) + 注入脚本桥接 + electron-store
| 模块 | 用途 |
|---|---|
| Electron | 桌面壳、窗口管理、托盘、全局快捷键 |
| electron-vite | 主进程 / 预加载脚本构建 |
| electron-store | 快捷键等配置持久化 |
| Media Session API | 控制中心 Now Playing、媒体键回调 |
未签名应用可能被 macOS 拦截，可执行：
xattr -cr /Applications/YouTube\ Music.app或右键应用 → 打开。
- 关闭 VPN / 代理后重试
- 菜单栏 账户 → 清除登录缓存并重启
- 使用 账户 → 登录…（
Cmd+L）打开登录页
播放音频后，Media Session API 会注册到控制中心。若被 Apple Music 抢占，请在控制中心切换播放来源为 YouTube Music。
按住窗口顶部左侧（交通灯按钮旁）或导航栏空白区域拖动。
本应用为第三方 WebView 壳，与 Google / YouTube 无官方关联。使用须遵守 YouTube 服务条款。
MIT