# sad-tui-player

基于 Rich/Textual 的咕咕咕音乐 TUI 播放器：浏览 `https://www.gggmusic.com/` 分类、日榜/周榜/月榜、音乐列表，解析歌曲播放链接并调用本地播放器播放。



## npm 安装

全局安装：

```bash
npm install -g @sad678/sad-tui-player
sad-tui-player
```

临时运行：

```bash
npx @sad678/sad-tui-player
```

解析单首歌：

```bash
sad-ggg-link https://www.gggmusic.com/thread-491.htm
```

npm 包会在首次运行时创建自己的 Python 虚拟环境并安装依赖。机器上需要提前安装 Python 3.11+。

## 一键启动

```powershell
cd C:\AI\Music\sad-tui-player
.\run.ps1
```

常用参数：

- `.\run.ps1 -NoInstall`：跳过依赖安装，直接启动
- `.\run.ps1 -Test`：安装依赖后运行测试
- `.\run.ps1 -NoInstall -Test`：跳过安装，直接运行测试

## 安装

```powershell
cd C:\AI\Music\sad-tui-player
.\.venv\Scripts\python.exe -m pip install -e .[dev]
```

如果 `.venv` 不存在：

```powershell
cd C:\AI\Music\sad-tui-player
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .[dev]
```

## 启动 TUI

```powershell
cd C:\AI\Music\sad-tui-player
.\.venv\Scripts\python.exe -m sad_tui_player
```

也可以用安装后的命令：

```powershell
.\.venv\Scripts\sad-tui-player.exe
```

快捷键：

- `Enter`：选择分类或播放选中的歌曲
- `r`：重新加载当前分类
- `s`：停止当前播放
- `q`：退出

播放器使用 `pygame` 内置播放，会先把歌曲缓存到本地临时目录，不再需要安装 `mpv`、`ffplay` 或 `vlc`。

网络请求默认 `trust_env=False`，避免本机代理环境变量影响固定站点的 HTTPS 请求。


## 播放控制

- `Enter`：播放选中歌曲并进入播放页
- `Space`：暂停 / 继续
- `n`：下一曲
- `p`：上一曲
- `m`：切换列表循环 / 单曲循环
- `PageUp` / `PageDown`：歌曲列表上下翻页
- `Home` / `End`：跳到列表顶部 / 底部
- `Esc` 或 `b`：从播放页返回列表页，歌曲继续播放
- `s`：停止播放
- `q`：退出

## 解析单首歌播放链接

```powershell
.\.venv\Scripts\python.exe -m sad_tui_player.cli https://www.gggmusic.com/thread-36951.htm
```

安装后的命令：

```powershell
.\.venv\Scripts\sad-ggg-link.exe https://www.gggmusic.com/thread-36951.htm
```

## 测试

```powershell
.\.venv\Scripts\python.exe -m pytest
```







## ????

- ???????????????????????????????????????????
- ?????????????????????????????????????????????

## ?????

????????????????????????????????????????????????????????