the-x-man/SPlayer

Important

严肃警告

请务必遵守 GNU Affero General Public License (AGPL-3.0) 许可协议
在您的修改、演绎、分发或派生项目中，必须同样采用 AGPL-3.0 许可协议，并在适当的位置包含本项目的许可和版权信息
禁止用于售卖或其他商业用途，如若发现，作者保留追究法律责任的权利
若发现未遵守 AGPL-3.0 许可协议的行为，本项目将永久停更
感谢您的尊重与理解

SPlayer

一个简约的音乐播放器

说明

本项目采用 Vue 3 全家桶和 Naïve UI 组件库及 Electron 开发
支持网页端与客户端，由于设备有限，目前仅适配 Win，其他平台可自行构建
仅对移动端做了基础适配，不保证功能全部可用
欢迎各位大佬指点和 Star 哦 😍

👀 Demo

SPlayer

🎉 功能

支持扫码登录
支持手机号登录
自动进行每日签到及云贝签到
封面主题色自适应
本地歌曲管理及分类 ~~以及音乐标签编辑~~
支持播放部分无版权歌曲（可能会与原曲不匹配，客户端独占功能）
下载歌曲（最高支持 Hi-Res）
新建歌单及歌单编辑
收藏 / 取消收藏歌单或歌手
每日推荐歌曲
私人 FM
云盘音乐上传
云盘内歌曲播放
云盘内歌曲纠正
云盘歌曲删除
支持逐字歌词
歌词滚动以及歌词翻译
MV 与视频播放
音乐频谱显示（暂时去除，还待完善）
音乐渐入渐出
支持 PWA
支持评论区及评论点赞
明暗模式自动 / 手动切换
~~移动端基础适配~~
~~i18n 支持~~

待办

完善音乐频谱
添加桌面歌词
多种布局方式
发表评论

🖼️ Screenshots

开发中，仅供参考

主页面

播放页面

发现页面

歌单页面

评论页面

本地音乐

📦️ 获取

稳定版

通常情况下，可以在 Releases 中获取稳定版

开发版

可以通过 GitHub Actions 工作流获取最新的开发版，目前开发版仅提供 Win 版本

Dev Workflow

⚙️ Vercel 部署

其他部署平台大致相同，在此不做说明

本程序依赖 NeteaseCloudMusicApi 运行，请确保您已成功部署该项目，并成功取得在线访问地址
点击本仓库右上角的 Fork，复制本仓库到你的 GitHub 账号
复制 /.env.example 文件并重命名为 /.env
将 .env 文件中的 RENDERER_VITE_SERVER_URL 改为第一步得到的 API 地址
```
RENDERER_VITE_SERVER_URL = "https://example.com";
```
将 Build and Output Settings 中的 Output Directory 改为 out/renderer
点击 Deploy，即可成功部署

⚙️ 服务器部署

重复 ⚙️ Vercel 部署 中的 1 - 4 步骤
克隆仓库

将链接中的 example/repository.git 替换为你要克隆的实际仓库的地址
```
git clone https://github.com/example/repository.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

命令	系统类型
`pnpm build:win`	Windows
`pnpm build:linux`	Linux
`pnpm build:mac`	MacOS

😘 鸣谢

特此感谢为本项目提供支持与灵感的项目

📢 免责声明

本项目部分功能使用了网易云音乐的第三方 API 服务，仅供个人学习研究使用，禁止用于商业及非法用途

同时，本项目开发者承诺 严格遵守相关法律法规和网易云音乐 API 使用协议，不会利用本项目进行任何违法活动。 如因使用本项目而引起的任何纠纷或责任，均由使用者自行承担。本项目开发者不承担任何因使用本项目而导致的任何直接或间接责任，并保留追究使用者违法行为的权利

请使用者在使用本项目时遵守相关法律法规，不要将本项目用于任何商业及非法用途。如有违反，一切后果由使用者自负。 同时，使用者应该自行承担因使用本项目而带来的风险和责任。本项目开发者不对本项目所提供的服务和内容做出任何保证

感谢您的理解

📜 开源许可

本项目仅供个人学习研究使用，禁止用于商业及非法用途
本项目基于 GNU Affero General Public License (AGPL-3.0) 许可进行开源
1. 修改和分发： 任何对本项目的修改和分发都必须基于 AGPL-3.0 进行，源代码必须一并提供
2. 派生作品： 任何派生作品必须同样采用 AGPL-3.0，并在适当的地方注明原始项目的许可证
3. 注明原作者： 在任何修改、派生作品或其他分发中，必须在适当的位置明确注明原作者及其贡献
4. 免责声明： 根据 AGPL-3.0，本项目不提供任何明示或暗示的担保。请详细阅读 GNU Affero General Public License (AGPL-3.0) 以了解完整的免责声明内容
5. 社区参与： 欢迎社区的参与和贡献，我们鼓励开发者一同改进和维护本项目
6. 许可证链接： 请阅读 GNU Affero General Public License (AGPL-3.0) 了解更多详情

the-x-man / SPlayer