GitHub 6K Star! 一款兼容性极好的音乐播放器！

今天要分享的这一款音乐播放器，我已经使用了好几年了，也算是见证了他一点一点的开发完善，到目前为止已经更新迭代无数次，非常nice的一款音乐播放器。

如果你是某音乐的重度用户，那么这款音乐播放器将是你的不二之选，这是一款由开发者 imsyy 打造的开源音乐播放器，基于 Vue 3 + TypeScript + Naïve UI + Electron 技术栈开发，界面简约优雅，功能却丝毫不打折。目前最新版本是 v3.0.0-beta.8（刚刚在2025年12月31日发布），正在快速迭代中，社区活跃度很高。

SPlayer 的设计灵感来源于现代 Material Design 和苹果音乐风格，界面干净清爽，支持封面主题色自适应——播放不同歌曲时，整个界面会自动提取专辑封面颜色进行着色，视觉效果超级沉浸！还有 Light/Dark/Auto 模式切换，完美适配你的系统主题。（我知道你们想要什么，文末获取！）

一、亮点功能

1、本地音乐 + 云端同步，听歌不局限

• 本地音乐管理：自动扫描设备中的音频文件，支持 MP3、FLAC 等主流格式，按歌手、专辑分类整理，找歌超方便。
• 云盘上传：支持将本地歌曲上传到云盘，换设备也能无缝听歌（通过 /src/api/cloud.ts 中的接口实现）。
• 音质自定义：可选择标准、无损、Hi-Res 等不同音质，满足对音质有要求的用户（代码见 /src/api/song.ts 的 songUrl 函数）。

2、歌词体验拉满，还支持动态效果

• 实时歌词同步：不仅能显示普通歌词，还支持 TTML 格式的动态歌词（类似 Apple Music 的逐字动画效果），代码中通过 songLyricTTML 接口实现。
• 歌词来源扩展：可对接第三方歌词 API，即使是冷门歌曲也能找到匹配的歌词。

3、开源免费，安全可控

• 完全开源：所有代码公开透明，不用担心隐私泄露或恶意插件。
• 免费无广告：用户协议（src/components/Modal/UserAgreement.vue）明确说明「永远不会向用户收取任何费用」，如果遇- 到付费版本，大概率是诈骗。
• 可自定义：开发者可以基于源码修改功能，比如添加新的音源、优化界面等。

二、技术党看过来

• 前端框架：Vue 3 + TypeScript
• 跨平台方案：Electron（支持 Windows、macOS、Linux）
• UI 组件：Naive UI（简洁现代的组件库）
• 状态管理：Pinia
• API 交互：Axios + 自定义请求封装
• 构建工具：Vite + electron-vite

三、软件截图

四、如何使用

1、直接下载安装

[下载地址](GitHub 6K Star! 一款兼容性极好的音乐播放器！)

2、源码构建

# 克隆仓库gitclone https://github.com/imsyy/SPlayer.git# 安装依赖npminstall# 开发模式运行npmrun dev# 构建安装包npmrun build:win# Windowsnpmrun build:mac# macOSnpmrun build:linux# Linux

3、Docker 部署（服务器端）

docker-composeup-d