Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/darknessomi/musicbox
网易云音乐命令行版本
https://github.com/darknessomi/musicbox
linux music netease-musicbox python
Last synced: 5 days ago
JSON representation
网易云音乐命令行版本
- Host: GitHub
- URL: https://github.com/darknessomi/musicbox
- Owner: darknessomi
- License: mit
- Created: 2014-08-05T03:28:24.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2022-06-28T07:42:25.000Z (over 2 years ago)
- Last Synced: 2024-10-29T14:56:22.803Z (2 months ago)
- Topics: linux, music, netease-musicbox, python
- Language: Python
- Homepage:
- Size: 1.77 MB
- Stars: 9,823
- Watchers: 284
- Forks: 1,581
- Open Issues: 237
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- stars - darknessomi/musicbox
- awesome - musicbox - 网易云音乐命令行版本 (Python)
- awesome - musicbox
- awesome - darknessomi/musicbox - 网易云音乐命令行版本 (Python)
- Awesome-GitHub-Repo - musicbox - 符合程序员气质的命令行版本网易云音乐。[<img src="https://tva1.sinaimg.cn/large/008i3skNly1gxlhtmg11mj305k05k746.jpg" alt="微信" width="18px" height="18px" />](https://mp.weixin.qq.com/s?__biz=MzUxNjg4NDEzNA%3D%3D&chksm=f9a1c4feced64de8403fe6c1df8ec5d12de8055df88c5c61f7ada49268fb4eac2916c94946b1&idx=1&mid=2247489335&scene=21&sn=7670e0a70d76b320a15724f033a77513#wechat_redirect) (好玩项目 / 沙雕项目)
- my-awesome - musicbox - 网易云音乐命令行版本 (Python)
- awesome-github-star - musicbox
- awesome-hacking-lists - darknessomi/musicbox - 网易云音乐命令行版本 (Python)
- jimsghstars - darknessomi/musicbox - 网易云音乐命令行版本 (Python)
README
# NetEase-MusicBox
**感谢为 MusicBox 的开发付出过努力的[每一个人](https://github.com/darknessomi/musicbox/graphs/contributors)！**
高品质网易云音乐命令行版本，简洁优雅，丝般顺滑，基于 Python 编写。
[](LICENSE)
[](https://pypi.org/project/NetEase-MusicBox/)
[](https://pypi.org/project/NetEase-MusicBox/)
## Demo
[](https://pypi.org/project/NetEase-MusicBox/)
## 功能特性
1. 320kbps 的高品质音乐
2. 歌曲，艺术家，专辑检索
3. 网易 22 个歌曲排行榜
4. 网易新碟推荐
5. 网易精选歌单
6. 网易主播电台
7. 私人歌单，每日推荐
8. 随心打碟
9. 本地收藏，随时加 ❤
10. 播放进度及播放模式显示
11. 现在播放及桌面歌词显示
12. 歌曲评论显示
13. 一键进入歌曲专辑
14. 定时退出
15. Vimer 式快捷键让操作丝般顺滑
16. 可使用数字快捷键
17. 可使用自定义全局快捷键
18. 对当前歌单列表进行本地模糊搜索
### 键盘快捷键
有 num + 字样的快捷键可以用数字修饰，按键顺序为先输入数字再键入被修饰的键，即 num + 后的快捷键。
| Key | Effect | |
| ------------------------------------- | --------------- | ------------------ |
| j | Down | 下移 |
| k | Up | 上移 |
| num + j | Quick Jump | 快速向后跳转 n 首 |
| num + k | Quick Up | 快速向前跳转 n 首 |
| h | Back | 后退 |
| l | Forword | 前进 |
| u | Prev Page | 上一页 |
| d | Next Page | 下一页 |
| f | Search | 当前列表模糊搜索 |
| \[ | Prev Song | 上一曲 |
| ] | Next Song | 下一曲 |
| num + \[ | Quick Prev Song | 快速前 n 首 |
| num + ] | Quick Next Song | 快速后 n 首 |
| num + Shift + g | Index for Song | 跳到第 n 首 |
| = | Volume + | 音量增加 |
| - | Volume - | 音量减少 |
| Space | Play/Pause | 播放/暂停 |
| ? | Shuffle | 手气不错 |
| m | Menu | 主菜单 |
| p | Present/History | 当前/历史播放列表 |
| i | Music Info | 当前音乐信息 |
| Shift + p | Playing Mode | 播放模式切换 |
| a | Add | 添加曲目到打碟 |
| Shift + a | Enter Album | 进入专辑 |
| g | To the First | 跳至首项 |
| Shift + g | To the End | 跳至尾项 |
| z | DJ List | 打碟列表 |
| s | Star | 添加到收藏 |
| c | Collection | 收藏列表 |
| r | Remove | 删除当前条目 |
| Shift + j | Move Down | 向下移动当前项目 |
| Shift + k | Move Up | 向上移动当前项目 |
| Shift + c | Cache | 缓存歌曲到本地 |
| , | Like | 喜爱 |
| . | Trash FM | 删除 FM |
| / | Next FM | 下一 FM |
| q | Quit | 退出 |
| t | Timing Exit | 定时退出 |
| w | Quit & Clear | 退出并清除用户信息 |
## 安装
### 必选依赖
1. `mpg123` 用于播放歌曲，安装方法参见下面的说明
2. `python-fuzzywuzzy` 用于模糊搜索
### 可选依赖
1. `aria2` 用于缓存歌曲
2. `libnotify-bin` 用于支持消息提示（Linux 平台）
3. `qtpy python-dbus dbus qt` 用于支持桌面歌词
(根据系统 qt 的版本还需要安装 pyqt4 pyqt4 pyside pyside2 中的任意一个)
4. `python-levenshtein` 用于模糊搜索
### PyPi 安装（\*nix 系统）
```bash
pip3 install NetEase-MusicBox
```
### Git clone 安装 master 分支（\*nix 系统）
```bash
git clone https://github.com/darknessomi/musicbox.git && cd musicbox
poetry build && poetry install
```
### macOS 安装
```bash
pip3 install NetEase-MusicBox
brew install mpg123
```
### Linux 安装
**注意：通过以下方法安装可能仍然需要`pip3 install -U NetEase-MusicBox`更新到最新版**。
#### Fedora
首先添加[FZUG](https://github.com/FZUG/repo/wiki)源，然后`sudo dnf install musicbox`。
#### Ubuntu/Debian
```bash
pip3 install NetEase-MusicBox
sudo apt-get install mpg123
```
#### Arch Linux
```bash
pacaur -S netease-musicbox-git # or $ yaourt musicbox
```
#### Centos/Red Hat
```bash
sudo yum install -y python3-devel
pip3 install NetEase-MusicBox
wget http://mirror.centos.org/centos/7/os/x86_64/Packages/mpg123-1.25.6-1.el7.x86_64.rpm
sudo yum install -y mpg123-1.25.6-1.el7.x86_64.rpm
```
## 配置和错误处理
配置文件地址: `~/.config/netease-musicbox/config.json`
可配置缓存，快捷键，消息，桌面歌词。
由于歌曲 API 只接受中国大陆地区访问，非中国大陆地区用户请自行设置代理（可用 polipo 将 socks5 代理转换成 http 代理）：
```bash
export http_proxy=http://IP:PORT
export https_proxy=http://IP:PORT
curl -L ip.cn
```
显示 IP 属于中国大陆地区即可。
### 已测试的系统兼容列表
| OS | Version |
| ----- | ------- |
| Arch | Rolling |
| macOS | 10.15.7 |
### 错误处理
当某些歌曲不能播放时，总时长为 00:01 时，请检查是否为版权问题导致。
如遇到在特定终端下不能播放问题，首先检查**此终端**下 mpg123 能否正常使用，其次检查**其他终端**下 musicbox 能否正常使用，报告 issue 的时候请告知以上使用情况以及出问题终端的报错信息。
同时，您可以通过`tail -f ~/.local/share/netease-musicbox/musicbox.log`自行查看日志。
mpg123 最新的版本可能会报找不到声音硬件的错误，测试了 1.25.6 版本可以正常使用。
### 已知问题及解决方案
- [#374](https://github.com/darknessomi/musicbox/issues/374) i3wm 下播放杂音或快进问题，此问题常见于 Arch Linux。尝试更改 mpg123 配置。
- [#405](https://github.com/darknessomi/musicbox/issues/405) 32 位 Python 下 cookie 时间戳超出了 32 位整数最大值。尝试使用 64 位版本的 Python 或者拷贝 cookie 文件到对应位置。
- [#347](https://github.com/darknessomi/musicbox/issues/347) 暂停时间超过一定长度（数分钟）之后 mpg123 停止输出，导致切换到下一首歌。此问题是 mpg123 的 bug，暂时无解决方案。
- [#791](https://github.com/darknessomi/musicbox/issues/791) 版权问题，master 分支已经修复
## 使用
```bash
musicbox
```
Enjoy it !
## 更新日志
2021-01-18 版本 0.3.1 错误修复
2020-10-23 版本 0.3.0 接口更新，错误修复
2018-11-28 版本 0.2.5.4 修复多处错误
2018-06-21 版本 0.2.5.3 修复多处播放错误
2018-06-07 版本 0.2.5.1 修复配置文件错误
2018-06-05 版本 0.2.5.0 全部迁移到新版 api，大量错误修复
[更多>>](https://github.com/darknessomi/musicbox/blob/master/CHANGELOG.md)
## LICENSE
[MIT](LICENSE)