https://github.com/dsy4567/rpi-tools
把树莓派 / Linux 机器改造成娱乐工具，亦可用作无需屏幕的第三方网易云音乐客户端
https://github.com/dsy4567/rpi-tools
mpg123 music-player netease-cloud-music neteasecloudmusicapi nodejs raspberry-pi
Last synced: 2 months ago
JSON representation
把树莓派 / Linux 机器改造成娱乐工具，亦可用作无需屏幕的第三方网易云音乐客户端
- Host: GitHub
- URL: https://github.com/dsy4567/rpi-tools
- Owner: dsy4567
- License: mit
- Created: 2024-02-16T16:09:43.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-02T14:47:56.000Z (over 1 year ago)
- Last Synced: 2025-02-02T15:31:51.759Z (over 1 year ago)
- Topics: mpg123, music-player, netease-cloud-music, neteasecloudmusicapi, nodejs, raspberry-pi
- Language: JavaScript
- Homepage:
- Size: 332 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rpi-tools
把树莓派 / Linux 机器改造成娱乐工具。
## ✨ 特色
- 纯键盘/蓝牙耳机 + 文字转语音交互，无需屏幕
- 专为难以联网的使用场景设计
- 代码很烂
## 💩 主要功能
- 网易云音乐
- 搜索单曲/歌单
- 更新歌单/日推
- MV 转音频（针对付费音乐）
- 按 id 下载歌单（支持心动模式）/ 单曲
- 清理/修复音乐
- 离线点赞，联网后同步
- 拍照（使用 `rpicam`）
- 蓝牙耳机切歌/使用快捷菜单进行常用操作
- 崩溃保护
- 多次崩溃后使用 [Music On Console](https://github.com/jonsafari/mocp) 提供最低限度的音乐播放服务
## 🛠 安装
> rpi-tools 仅可在 Linux 平台运行，如需在 Windows 进行开发，可在 Win 安装依赖后使用 WSL 或 Linux 虚拟机运行
1. 下载源码，安装依赖
```bash
# 安装音频服务 pipewire
sudo apt install pipewire pipewire-pulse pulseaudio-utils
# 或 pulseaudio
sudo apt install pulseaudio pulseaudio-module-bluetooth
# 安装其他必须依赖
sudo apt install mpg123 espeak bluez bluez-tools
# 非必须但建议安装的依赖，不安装会导致少量功能残缺
sudo apt install moc cpufrequtils ffmpeg screen
# 安装最新版的 nodejs
curl -fsSL https://www.unpkg.com/n/bin/n | bash -s latest
# 克隆仓库，安装依赖
git clone --recursive https://github.com/dsy4567/rpi-tools
cd rpi-tools
sudo npm i -g pnpm
pnpm i --no-optional
# 如果开发时遇到编辑器自动补全异常，请尝试执行以下命令
cd ./NeteaseCloudMusicApi
pnpm i --no-optional
cd ./NeteaseCloudMusicApi-hook
pnpm i --no-optional
```
2. 配置 sudo 免密（用于关机重启、设置进程优先级、使用 `rpicam` 拍照等）
3. 登录网易云音乐（可选）
> **⚠ 警告：登录第三方网易云音乐客户端存在较大封号风险**
在 `rpi-tools/data/` 文件夹下创建 `ncmCookie.txt`，内容参考：
```text
MUSIC_U=******;
```
或者，按照控制台输出的提示，使用浏览器登录网易云音乐
4. 运行
```bash
bash ./run.sh
```
## 🕺 操作方法
### 🎧 蓝牙耳机
| 按键 | 操作 |
| ----------- | ---------------------------------------------------------------- |
| 播放/暂停键 | 播放/暂停，选中菜单 |
| 上一曲 | 打开快捷菜单（播放状态下），上一曲（暂停状态下），选择上一个菜单 |
| 下一曲 | 下一曲（播放状态下），打开快捷菜单（暂停状态下），选择下一个菜单 |
### ⌨ 键盘
无特别说明的按键均需在主页下使用
| 按键 | 操作 |
| ------------------ | --------------------------------------------------- |
| `H` | 查看当前可用按键 |
| `b` / `n` | 上、下一曲/选项 |
| `Space` | 播放/暂停 |
| `m` | 打开快捷菜单 |
| `Esc` / `Del` | 返回上一级菜单 |
| `g` / `h` | 音量-/+ 3% |
| `t` / `y` | 音量-/+ 5% |
| `p` | 切换歌单（按 `b` / `n` / `Enter` 选择和确认项目） |
| `U` | 更新歌单（按 `b` / `n` / `Enter` 选择和确认项目） |
| `0` ~ `9` | 快速切换歌单 |
| `N` | 顺序播放 |
| `R` | 单曲循环 |
| `S` | 随机播放 |
| `i` | 当前音乐信息 |
| `L` | 说出歌词 |
| `l` | 添加到喜欢（按 `b` / `n` / `Enter` 选择和确认项目） |
| `D` | 下载（按 `b` / `n` / `Enter` 选择和确认项目） |
| `s` | 搜索 |
| `Q` / `Ctrl` + `C` | 退出 |
| 更多选项 | |
| -------- | ------------------------------------------------------------- |
| `M` | 进入更多选项 |
| `c` | 使用 `rpicam-still` 拍照 |
| `S` | 立即关机（更多选项下） |
| `s` | 40 分钟后关机（更多选项下） |
| `p` | 性能选项（更多选项下，按 `b` / `n` / `Enter` 选择和确认项目） |
## 📄 快捷菜单项
- 喜欢
- 下一曲
- 网易云音乐-更多选项
- 选择播放列表
- 更新播放列表
- 歌曲信息
- 更新登录信息
- 取消全部下载任务
- 删除播放列表
- 电源
- 关机
- 定时关机
- 重启
- 小工具
- 拍照
- 上一曲
## 🕒 待开发
- 使用 TypeScript 重写
- 添加对 B 站视频的支持