musicfox是一款使用Dart编写的网易云音乐命令行程序。
一、为什么做这个项目
在开始这个项目的之前，其实是已经有一个基于命令行的网易云音乐项目——musicbox。
我也使用它听了很长一段时间的歌了，其中还贡献过一些代码，修复几个小问题。那为什么还要重新造一个轮子呢？
- musicbox缺少一些我特别想要的功能
- musicbox使用python进行编写，我对python并不是很熟悉，所以修改或者新增功能时比较麻烦
二、为什么使用Dart
- Dart的语法极像Java，我本身也学过Java，因此学习成本较低；
- Dart可以将代码编译成能在三大平台（Windows、Linux、Mac）上直接运行的可执行程序。
三、效果预览
四、安装
依赖mpg123，必须先安装mpg123
Mac
提供两种方式安装：
- 进入到Release下载musicfox.mac文件，在iTerm或Terminal中运行
- 使用brew安装：
brew tap anhoder/musicfox && brew install musicfox
Linux(Ubuntu)
进入到Release下载musicfox.ubuntu文件，在终端中运行。
本人没有Linux系统，该执行文件是在WSL2(Ubuntu 2004)下打包的，不确定其他Linux系统是否也能正常使用
Windows
下载Windows可执行文件，在命令行(推荐Windows Terminal)中运行即可。
Windows下存在几个已知问题，暂时没有解决方法：
- 暂停时会延迟几秒，播放时不会延迟
- 登录或搜索输入时，会吞掉第一个字符
- 上、下、左、右及ESC键无法监听，只能使用字母代替这些操作
- 命令行窗口大小发生变化后，UI会变乱（因为Windows不支持resize事件）
因为存在以上问题，所以推荐在WSL下使用，WSL的声音转发可以参考我的另一个项目。
五、通知功能
Mac
Mac下默认使用AppleScript发送通知。如下：
如果想要更好的通知体验，可以安装terminal-notifier:
brew install terminal-notifier
效果如下：
Linux
Linux可以安装libnotify-bin来使用通知功能（未经测试）
Windows
Windows下可以安装notifu实现通知，体验不太好（没找到其他更好的通知工具）
当然，如果你有更好的命令行通知程序，你也可以自己实现INotifier接口达到你想要的效果：
abstract class INotifier { // 检查该通知程序是否可用 bool isAvailable(); // 发送消息 void send(String message, {String title, String subtitle, String soundName, String groupID, String activateID, String appIcon, String contentImage, String openURL, String executeCmd}); }
六、使用
$ musicfox
按键：
| 按键 | 作用 | 备注 |
|---|---|---|
| h/H/LEFT | 左 | Windows只能使用h |
| l/L/RIGHT | 右 | Windows只能使用l |
| k/K/UP | 上 | Windows只能使用k |
| j/J/DOWN | 下 | Windows只能使用j |
| q/Q | 退出 | Windows只能使用q |
| space | 暂停/播放 | |
| [ | 上一曲 | |
| ] | 下一曲 | |
| - | 减小音量 | |
| = | 加大音量 | |
| n/N/ENTER | 进入选中的菜单 | Windows只能使用n |
| b/B/ESC | 返回上级菜单 | Windows只能使用b |
| w/W | 退出并退出登录 | Windows只能使用w |
| p | 切换播放方式 | |
| P | 心动模式(仅在歌单中时有效) | Windows下使用o |
| , | 喜欢当前播放歌曲 | |
| < | 喜欢当前选中歌曲 | Windows下使用; |
| . | 当前播放歌曲移除出喜欢 | |
| > | 当前选中歌曲移除出喜欢 | Windows下使用' |
| / | 标记当前播放歌曲为不喜欢 | |
| ? | 标记当前选中歌曲为不喜欢 | Windows下使用\ |
七、TODO
八、伴生项目
在该项目的开发过程中，我将一些通用的功能模块单独抽离出来，做成了几个伴生项目：
- mp3_player: dart命令行调用mpg123播放音乐
- netease_music_request: Dart实现的网易云音乐接口库，使用Dio发起请求，CookieJar管理Cookie信息
- colorful_cmd: 使用dart实现的一些命令行UI组件，如：WindowUI命令行窗口应用UI、RainbowProgress彩虹进度条、NotifierProxy三大平台通知代理、ColorText颜色文本...
九、感谢
感谢以下项目及其贡献者们（不限于）：