# music123-desktop

网易云音乐 Windows 原生桌面播放器，基于 Python、PySide6（Qt 6）和 QMediaPlayer。

本仓库只包含桌面版源码，不包含网页端、服务端配置或已构建的 exe。

## 功能

- 网易云官方排行榜，首页数据缓存，点击秒开
- 歌曲搜索、最近播放、播放队列
- 导入公开歌单：链接、分享文案或数字 ID
- 标准 / 较高 / 极高 / 无损音质切换
- 逐行歌词、精确居中、点击歌词跳转
- 全屏播放页、黑胶旋转、音量与播放进度控制
- 播放栏显示当前播放歌单
- 应用内检查更新、自动下载、SHA-256 校验和重启安装

## 开发运行

要求 Python 3.11+，推荐 Python 3.13。

```powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python src\main.py
```

## 构建 Windows exe

```powershell
pip install pyinstaller
powershell -ExecutionPolicy Bypass -File .\build.ps1
```

产物位于 `dist\网易云播放器.exe`。

## 目录

```text
src/
  main.py           主窗口、播放状态与导航
  widgets.py        黑胶、歌词、歌曲列表等原生组件
  theme.py          QSS 视觉系统
  core.py           网易云接口封装、歌词解析
  import_dialog.py  导入歌单弹窗
  updater.py        版本检查、自动下载与安装
  version.py        版本号与更新地址
  icon.ico          应用图标
```

## 说明

本项目为非官方客户端，仅供学习交流。音乐内容、商标及相关权利归网易云音乐及原始权利人所有。

## 许可证

GNU Affero General Public License v3.0，详见 [LICENSE](LICENSE)。