Spotify 设计风格的网易云音乐播放器
翻譯準備中
取自儲存庫 README
正在載入完整 README。
檢視完整 README ↗这是一个基于 Next.js + Electron 配合网易云 node.js API 的仿 Spotify UI 的跨平台音乐播放器客户端,是我初学 Electron 的第一个作品。
包管理工具: 用于包管理(版本见 packageManager),用于运行脚本与测试。
支持网页端与客户端,由于设备有限,目前仅保证 Windows 和 MacOS 系统的适配,App 开发中。
前往 GitHub Releases 获取适合当前系统的安装包:
| 平台 | 架构 | 安装包格式 | 适用机型 |
|---|---|---|---|
| macOS | Apple Silicon (arm64) | .dmg / .zip | Apple Silicon Mac(推荐) |
| macOS | Intel (x64) | .dmg / .zip | Intel 处理器 Mac |
| Windows | 64 位 (x64) | .exe | Intel / AMD 处理器(绝大多数用户推荐) |
| Windows | ARM64 | .exe | ARM 架构 Windows 设备 |
[!NOTE] macOS 首次安装提示“对系统有害”或“已损坏”的处理方法:
Scopify 为个人开源项目,未向 Apple 购买付费商业开发者证书公证。从网络下载未公证的应用时,macOS Gatekeeper 安全机制会自动打上隔离标志并弹出警告,这并非应用存在恶意行为或真正损坏。
- 打开下载的
.dmg镜像,务必先将Scopify.app拖入系统的「应用程序」(Applications)目录(切勿直接在只读 DMG 中双击运行);- 打开系统自带的「终端」(Terminal),粘贴并运行以下命令解除隔离:
sudo xattr -rd com.apple.quarantine /Applications/Scopify.app- 输入开机密码后回车(输入时密码不显示字符),即可正常双击启动 Scopify。
- (备选) 也可以在 Mac 「系统设置」→「隐私与安全性」→「安全性」 中找到拦截提示,点击 “仍要打开”。
仓库使用 pnpm Workspaces + Turborepo 管理 Web、Electron 和共享契约:
repo/
├── frontend/
│ ├── apps/
│ │ ├── web/ # Next.js Web 与 Electron Renderer 源码
│ │ ├── desktop/ # Electron 主进程、预加载与打包配置
│ │ └── mobile/ # Flutter 预留入口(submodule)
│ └── packages/
│ └── desktop-contract/ # Web 与 Electron 之间的类型化契约
└── backend/
└── api-enhanced/ # NetEase API 后端(submodule)
新建或修改代码前,请先阅读:
特别感谢以下项目的开源:
Scopify 现在把桌面客户端、Web 前端和后端分开管理。Web 和桌面客户端需要能访问一个独立运行的 NetEase API 后端。
请确保你后端的实际运行当然你也可以看这个文档部署文档来部署你的专有后端作为项目后端运行。
git submodule update --init --recursive # 初次克隆时需要
pnpm run dev:backend # 运行后端
pnpm install
pnpm run dev:web # 仅 Next.js Web
pnpm run dev:desktop # 仅 Electron(开发时使用 Web dev server),确保你的 dev:web 已运行
pnpm run dev # Web + Electron
pnpm run dev:full # Web + Electron + backend
# 其他网页
pnpm run dev:docs # 仅 docs(文档网站),确保你的 dev:web 已运行
功能与界面会随版本持续更新。你可以通过下面的功能图谱快速了解产品能力,完整说明与最新界面截图请查看在线文档:
mindmap
root((Scopify 功能图谱))
界面与布局
顶栏导航与常驻搜索
可收起的音乐库侧栏
正在播放与歌词队列面板
常驻播放栏
内容发现
每日与个性化推荐
歌单专辑与歌手
私人 FM 与电台
播客声音
评论内容
Lattice 歌单视图
搜索与导航
快捷搜索
常驻搜索栏
分类结果页
歌词搜索与完整歌词预览
LRC 与 YRC 导出
乐谱搜索与谱页预览
MV 卡片与悬停预览
命令面板
播放与队列
播放控制
播放模式
待播队列
正在播放面板
输出设备
音乐百科与乐谱
MV 视频
普通播放布局
剧场模式
网页全屏与系统全屏
保留进度切换清晰度
歌单与专辑 MV 预览
相似 MV 与评论互动
歌词与 Folia
动态歌词舞台
歌词来源与匹配
时间轴校准
舞台控制面板与分层退出
样式与视觉主题
音频体验
音质选择
十段均衡器
ReplayGain
声音效果
账户与音乐库
喜欢与收藏
最近播放
我的云盘
自建歌单
听歌足迹
用户与网易乐签
社交与通知
动态与乐迷团
乐迷团筛选与来源标识
瀑布流与动态详情浮层
音乐分享与评论互动
私信
通知中心
个性化与效率
命名主题与时段轮换
缓存与登录设备
语言与主题
快捷键
命令面板
运行设置
桌面端集成
桌面歌词
桌面壁纸与托盘
灵动岛与 Windows 任务栏歌词
macOS 菜单栏歌词与播放控制
MCP 播放控制
Discord 状态
客户端更新
本地后端与诊断
本地预览文档站:pnpm run dev:docs(需先运行 pnpm run dev:web)。
版本号的发布规则
x.y.z
x: 重大更新,可能包含不兼容的 API 修改y: 次要更新,添加了新功能,但保持向后兼容z: 修复 bug 和小的改进,不添加新功能本项目基于 GNU Affero General Public License v3.0 (AGPL-3.0) 许可开源。