Musike：YouTube 曲库音乐播放器

项目简介

Musike 是一个面向 YouTube 曲库的个人音乐播放器：任意歌曲或音乐视频都能以音频或视频形式播放，无广告、无需账号、无需订阅。它可作为 Windows、macOS、Linux 桌面应用，Android、Android TV、iPhone 应用，任意浏览器中可安装的 PWA，以及 Docker 镜像运行。

服务端用 yt-dlp 获取原始串流并把字节转发给播放器，因此不需要登录账号。歌单和收藏保存在本地 library.json 文件中。

主要功能

收听

• 搜索 YouTube Music，提供 Songs、Videos、Albums 三个标签，输入时给出建议
• 粘贴 YouTube 链接直接播放
• Genres 按钮按流派浏览（Rock、Pop、Hip-hop、Indie、Metal、Jazz 等），查看流派下的艺人与歌曲
• 艺人页：热门单曲，以及全部专辑与单曲；专辑页：按原始顺序播放、随机播放或一键保存为歌单
• Search a list：用逗号分隔输入多首歌，自动挑选最佳匹配，可替换、播放、收藏或加入歌单
• 队列支持下一首播放、随机与循环（队列或单曲）；队列结束后自动播放相似歌曲电台
• HTTP Range 串流即时拖动进度，并预加载下一首

视频

• 视频模式可放在侧栏、手机全屏或悬浮迷你播放器
• 自动为歌曲匹配艺人官方频道的 MV
• Cinema 模式：按钮、双击或 F 键最大化，控制栏自动淡出，支持真全屏
• SD 画质（启动快）或 HD 720p（本地缓存）

曲库与外观

• 歌单、收藏与最近播放历史；可多选曲目批量播放、收藏或加入歌单
• 备份为文件，可在另一台设备的 Musike 中合并或替换导入，导入前可预览
• 英文与巴西葡萄牙语界面（按设备切换）；深浅色主题与任意强调色（8 种预设或自定义）
• 可显示/隐藏 Now Playing 面板、侧栏歌单、仅图标的紧凑侧栏、专辑栏、背景纹理及首页各区块
• 从 320 px 手机到超宽屏自适应；支持锁屏、耳机与媒体键控制（Media Session），并记住播放进度

桌面与移动端

• 桌面端为原生窗口、自带标题栏，更新时自动备份曲库，并自动下载与维护 yt-dlp、Deno、FFmpeg
• 手机端独立运行，不需要电脑或服务器，由手机端自行请求音频流
• 息屏继续播放，通知栏、锁屏与耳机均可控制，来电或拔出耳机会暂停
• Android TV 上出现在电视启动器并切换为遥控器操作的大屏界面
• Docker 镜像支持 amd64 与 arm64（树莓派），局域网内任意设备或经 Tailscale 访问

安装与使用

桌面端与移动端安装包均来自 latest release：

• Windows：运行 Musike-Setup-<version>-Windows.exe，仅为当前用户安装，创建桌面与开始菜单快捷方式
• macOS：按芯片选择 -macOS-arm64.dmg（Apple Silicon）或 -macOS-x64.dmg（Intel），打开后把 Musike 拖入「应用程序」，需 macOS 12 或更新版本
• Linux：.deb 或 .AppImage，各有 x64 与 arm64
• Android / Android TV / iPhone / Docker：见 release 页面与 README 的对应章节

自行构建 Windows 安装包：

pnpm install && pnpm installer

macOS 若提示应用「已损坏，无法打开」，可在终端移除下载标记：

xattr -dr com.apple.quarantine /Applications/Musike.app

注意事项

• 安装包尚未代码签名：Windows 首次运行会提示「Windows 已保护你的电脑」，需点击更多信息再选仍要运行；macOS 需在「系统设置 > 隐私与安全性」中点击仍要打开。
• 桌面端首次启动会下载 yt-dlp 与 Deno（约 60 MB），并在后台下载 FFmpeg（约 80 MB，用于 HD 视频），数据位于 %APPDATA%\Musike。
• 手机端目前仅支持音频，没有视频模式；iPhone 版需通过 AltStore、SideStore 或 Sideloadly 安装。
• 播放依赖 yt-dlp，若出现播放错误，可在提示中直接点击「更新」（Stable 或 Nightly 通道）。
• 更新时直接覆盖安装即可，歌单与收藏会保留。

---

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