imsyy / SPlayer
- среда, 20 августа 2025 г. в 00:00:02
🎉 一个简约的音乐播放器,支持逐字歌词,下载歌曲,展示评论区,音乐云盘及歌单管理,音乐频谱,移动端基础适配 | 网易云音乐 | A minimalist music player
A simple music player
Important
本项目采用 Vue 3 + TypeScript + Naïve UI + Electron 开发
支持网页端与客户端,由于设备有限,目前仅适配 Win
,其他平台可自行解决兼容性后进行构建
仅对移动端做了基础适配,不保证功能全部可用
请注意,本程序不打算开发移动端,也不会对移动端进行完美适配,仅保证基础可用性
欢迎各位大佬 Star
😍
i18n
支持开发中,仅供参考
通常情况下,可以在 Releases 中获取稳定版
可以通过 GitHub Actions
工作流获取最新的开发版,目前开发版仅提供 Win
版本
安装及配置
Docker
将不在此处说明,请自行解决
请尽量拉取最新分支后使用本地构建方式,在线部署的仓库可能更新不及时
# 构建
docker build -t splayer .
# 运行
docker run -d --name SPlayer -p 25884:25884 splayer
# 或使用 Docker Compose
docker-compose up -d
# 从 Docker Hub 拉取
docker pull imsyy/splayer:latest
# 从 GitHub ghcr 拉取
docker pull ghcr.io/imsyy/splayer:latest
# 运行
docker run -d --name SPlayer -p 25884:25884 imsyy/splayer:latest
以上步骤成功后,将会在本地 localhost:25884 启动,如需更换端口,请自行修改命令行中的端口号
其他部署平台大致相同,在此不做说明
本程序依赖 NeteaseCloudMusicApi 运行,请确保您已成功部署该项目,并成功取得在线访问地址
点击本仓库右上角的 Fork
,复制本仓库到你的 GitHub
账号
复制 /.env.example
文件并重命名为 /.env
将 .env
文件中的 VITE_API_URL
改为第一步得到的 API 地址
VITE_API_URL = "https://example.com";
将 Build and Output Settings
中的 Output Directory
改为 out/renderer
点击 Deploy
,即可成功部署
重复 ⚙️ Vercel 部署
中的 1 - 4 步骤
克隆仓库
git clone https://github.com/imsyy/SPlayer.git
安装依赖
pnpm install
# 或
yarn install
# 或
npm install
编译打包
pnpm build
# 或
yarn build
# 或
npm build
将站点运行目录设置为 out/renderer
目录
本地部署需要用到 Node.js
。可前往 Node.js 官网 下载安装包,请下载最新稳定版
安装 pnpm
npm install pnpm -g
克隆仓库并拉取至本地,此处不再赘述
使用 pnpm install
安装项目依赖(若安装过程中遇到网络错误,请使用国内镜像源替代,此处不再赘述)
复制 /.env.example
文件并重命名为 /.env
并修改配置
打包客户端,请依据你的系统类型来选择,打包成功后,会输出安装包或可执行文件在 /dist
目录中,可自行安装
命令 | 系统类型 |
---|---|
pnpm build:win |
Windows |
pnpm build:linux |
Linux |
pnpm build:mac |
MacOS |
特此感谢为本项目提供支持与灵感的项目
本项目部分功能使用了网易云音乐的第三方 API 服务,仅供个人学习研究使用,禁止用于商业及非法用途
同时,本项目开发者承诺 严格遵守相关法律法规和网易云音乐 API 使用协议,不会利用本项目进行任何违法活动。 如因使用本项目而引起的任何纠纷或责任,均由使用者自行承担。本项目开发者不承担任何因使用本项目而导致的任何直接或间接责任,并保留追究使用者违法行为的权利
请使用者在使用本项目时遵守相关法律法规,不要将本项目用于任何商业及非法用途。如有违反,一切后果由使用者自负。 同时,使用者应该自行承担因使用本项目而带来的风险和责任。本项目开发者不对本项目所提供的服务和内容做出任何保证
感谢您的理解