SPlayer-Next：跨平台桌面音乐播放器

项目简介

SPlayer-Next 是 SPlayer 的后继项目，一款跨平台桌面音乐播放器，支持 Windows / macOS / Linux。音频解码、系统媒体控制与任务栏歌词等核心能力由 Rust 原生模块提供：audio-engine（FFmpeg 解码、播放、FFT 频谱、封面提取）、media-ctrl（系统媒体控制 + Discord Rich Presence）、taskbar-lyric（Windows 任务栏歌词渲染）。项目主页：http://splayer-next.imsyy.top/

主要功能

• 广泛的格式支持：MP3、FLAC、WAV、AAC、OGG、APE 等，通过 FFmpeg 解码
• 丰富的歌词体验：支持 LRC / QRC / YRC / TTML，逐字高亮与翻译，提供桌面歌词、灵动岛歌词、任务栏歌词窗口
• 流媒体服务器：Subsonic / Navidrome / Jellyfin / Emby，支持多服务器与自动连接
• 音频频谱：实时 FFT 可视化
• 元数据编辑：可编辑本地曲目的标签与封面
• 下载管理：内置下载管理器，已下载歌曲优先播放并显示下载状态
• 系统媒体集成：Windows SMTC / Linux MPRIS / macOS Now Playing，以及 Discord RPC
• 高性能音频引擎：FFmpeg + Rust，支持 Windows WASAPI 独占输出、Linux PipeWire 自适应采样率
• 智能交叉过渡：双槽位预载与曲尾交接调节
• 自适应主题：基于封面取色，支持浅色 / 深色 / 自动
• Last.fm 记录：支持 Last.fm scrobbling

安装与使用

环境要求

• Node.js >= 22
• pnpm >= 10
• Rust toolchain（用于构建原生模块）

本地运行

# 1. 安装依赖
pnpm install

# 2. 启动开发版应用（以 debug 模式构建原生模块后启动 Electron）
pnpm dev

pnpm dev 与 pnpm build 会自动编译原生模块；若只调试 UI，可设置 SKIP_NATIVE_BUILD=true 跳过。

打包构建

pnpm build         # 完整构建：clean → native → typecheck → 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）

注意事项

• 项目采用 AGPL-3.0 许可证：修改与分发需同样以 AGPL-3.0 发布并提供完整源代码；衍生作品需保留原项目的许可证与版权声明；用于销售等盈利目的时需提供源代码及原项目链接。
• 软件按「原样」提供，不附带任何形式的担保。
• 项目声明仅供个人学习与研究使用，不得用于商业或非法用途；部分功能依赖第三方 API，使用者需自行确保符合相关法律法规与服务协议。
• 歌词显示基于 applemusic-like-lyrics，部分在线音乐能力基于 NeteaseCloudMusicApiEnhanced。

---

本作品整理自 GitHub 开源项目 SPlayer-Dev/SPlayer-Next，原作者 @SPlayer-Dev，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。