musicfox是一款使用Dart编写的网易云音乐命令行程序。
一、为什么做这个项目
在开始这个项目的之前,其实是已经有一个基于命令行的网易云音乐项目——musicbox。
我也使用它听了很长一段时间的歌了,其中还贡献过一些代码,修复几个小问题。那为什么还要重新造一个轮子呢?
- musicbox缺少一些我特别想要的功能
- musicbox使用python进行编写,我对python并不是很熟悉,所以修改或者新增功能时比较麻烦
二、为什么使用Dart
- Dart的语法极像Java,我本身也学过Java,因此学习成本较低;
- Dart可以将代码编译成能在三大平台(Windows、Linux、Mac)上直接运行的可执行程序。
三、效果预览
![欢迎界面](/post-images/1617678066308.png)
![主界面1](/post-images/1617678078304.png)
![主界面2](/post-images/1617678089104.png)
四、安装
依赖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
发送通知。如下:
![AppleScript](/post-images/1617678108326.png)
如果想要更好的通知体验,可以安装terminal-notifier
:
brew install terminal-notifier
效果如下:
![terminal-notifier](/post-images/1617678123055.png)
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颜色文本...
九、感谢
感谢以下项目及其贡献者们(不限于):