SPlayer-Dev/SPlayer-Next

---

功能特性

• 🎵 广泛的格式支持 —— MP3、FLAC、WAV、AAC、OGG、APE 等，基于 FFmpeg 解码
• 📝 丰富的歌词 —— LRC / QRC / YRC / TTML，逐字高亮与翻译，支持桌面、灵动岛、任务栏歌词窗口
• 🌐 流媒体服务 —— Subsonic / Navidrome / Jellyfin / Emby（多服务器、自动连接）
• 🖥️ 跨平台 —— Windows / macOS / Linux
• 🎚️ 音乐频谱 —— 实时 FFT 可视化
• 🏷️ 元信息编辑 —— 编辑本地曲目标签与封面
• ⬇️ 下载 —— 内置下载管理器
• 🎧 系统媒体集成 —— Windows SMTC / Linux MPRIS / macOS Now Playing + Discord RPC
• ⚡ 高性能音频引擎 —— FFmpeg + Rust
• 🎨 自适应主题 —— 基于封面取色，Light / Dark / Auto
• 📈 Last.fm Scrobble

开发

环境要求

• Node.js >= 22
• pnpm >= 10
• Rust 工具链（构建原生模块所需，见下）

原生模块

核心性能特性由 Rust 编写的原生模块提供：

模块	说明
audio-engine	高性能音频解码（FFmpeg）、播放、FFT 频谱、封面提取
media-ctrl	系统媒体控制 + Discord Rich Presence
taskbar-lyric	Windows 任务栏歌词原生渲染

pnpm dev 与 pnpm build 会自动编译原生模块。若只做 UI 开发想跳过，可设置 SKIP_NATIVE_BUILD=true。

快速开始

# 1. 安装依赖
pnpm install

# 2. 启动开发（先以 debug 构建原生模块，再启动 Electron）
pnpm dev

构建

pnpm build         # 完整构建：清理 → 原生模块 → 类型检查 → electron-vite

pnpm build:win     # 打包 Windows
pnpm build:mac     # 打包 macOS
pnpm build:linux   # 打包 Linux（AppImage / deb / rpm / tar.gz / pacman）

默认仅构建当前架构，暂不支持交叉编译。

其他脚本

pnpm typecheck        # tsc + vue-tsc（node + web 双目标）
pnpm lint             # ESLint
pnpm format           # Prettier
pnpm build:native     # 仅构建 Rust 原生模块（加 `--dev` 为 debug 构建）

致谢

特别感谢以下让 SPlayer-Next 成为可能的开源项目：

• applemusic-like-lyrics —— 类 Apple Music 歌词显示组件库
• NeteaseCloudMusicApiEnhanced —— 网易云音乐 API 备份 + 增强

开源许可

本项目基于 GNU Affero General Public License v3.0 (AGPL-3.0) 许可开源。

• 修改与分发： 任何修改或分发都必须同样基于 AGPL-3.0，并一并提供完整源代码。
• 派生作品： 必须同样采用 AGPL-3.0，并在适当位置保留本项目的许可与版权信息。
• 署名： 必须保留原作者及版权信息。可为二次开发添加你自己的署名，但不得移除或篡改原始信息。
• 商业用途： 如用于售卖或其他盈利用途，必须提供源代码及原项目链接。由于本项目涉及第三方服务，商业使用可能存在法律风险。
• 免责： 本软件按「现状」提供，不附带任何形式的担保，详见 AGPL-3.0。

免责声明

本项目仅供个人学习与研究使用，禁止用于商业及非法用途。部分功能依赖第三方 API，使用者须自行确保其使用符合相关法律法规及服务协议。对于因使用本项目而产生的任何直接或间接后果，作者不承担任何责任。