go-musicfox极客风网易云音乐命令行客户端

介绍

go-musicfox是用Go写的又一款网易云音乐命令行客户端，支持UnblockNeteaseMusic、各种音质级别、lastfm、MPRIS、MacOS交互响应（睡眠暂停、蓝牙耳机连接断开响应、菜单栏控制等）.

1. 启动

2. 主界面

3. 通知

4. 登录

5. 搜索

6. Last.fm 授权

7. macOS NowPlaying

8. UnblockNeteaseMusic

9. macOS 歌词显示

需要满足以下条件：

1. go-musicfox >= v3.7.7

2. 下载和安装 LyricsX 的 go-musicfox 的 fork 版本

3. 在 LyricsX 设置中，打开使用系统正在播放的应用

安装

[macOS]

[1. 通过 Homebrew 安装]

$ brew install anhoder/go-musicfox/go-musicfox

如果你之前安装过 musicfox，需要使用下列命令重新链接:

$ brew unlink musicfox && brew link --overwrite go-musicfox

[2. 直接下载]

在 Release 下载 macOS 的可执行文件。

[Linux]

[1. 使用发行版软件包（推荐）]

[Arch Linux]

从 AUR 安装

$ paru -S go-musicfox # 下载源代码编译安装
$ paru -S go-musicfox-bin # 下载安装预编译好的二进制

从 archlinuxcn 安装

首先添加 archlinuxcn 仓库到系统。

# pacman -S go-musicfox

Gentoo Linux

从 gentoo-zh Overlay 安装

$ eselect repository enable gentoo-zh
$ emerge --sync
$ emerge -a media-sound/go-musicfox

NixOS

从 void-packages-zh 安装。

[2. 通过 Homebrew 安装]

$ brew install anhoder/go-musicfox/go-musicfox

如果你之前安装过 musicfox，需要使用下列命令重新链接:

$ brew unlink musicfox && brew link --overwrite go-musicfox

[3. 直接下载]

在 Release 下载 Linux 的可执行文件。

[Windows]

[1. 通过 scoop 安装]

scoop bucket add go-musicfox https://github.com/go-musicfox/go-musicfox.git
​
scoop install go-musicfox

[2. 直接下载]

在 Release 下载 Windows 的可执行文件。

[手动编译]

需要 Go v1.13 及以上版本

$ git clone https://github.com/go-musicfox/go-musicfox

$ go mod download

# Linux 编译前需要安装 flac

$ make # 编译到 bin 目录下
$ make install # 安装到 $GOPATH/bin下

[使用]

$ musicfox

[注意事项]

• 请务必使用等宽字体，或将配置项 doubleColumn 设为 false，否则双列显示排版可能会混乱

• 如果在使用时出现莫名奇妙的光标移动、切歌或暂停等现象，请将配置项 enableMouseEvent 设置为 false

• 本应用不对 macOS 原生终端和 Windows 的命令提示符（CMD）做兼容处理（#99）

macOS 用户推荐使用 iTerm2 或 Kitty

Linux 用户推荐使用 Kitty

Windows 用户推荐使用 Windows Terminal，使用体验更佳

[快捷键]

[应用内快捷键]

按键	作用	备注
h/H/← (左方向)	左
l/L/→ (右方向)	右
k/K/↑ (上方向)	上
j/J/↓ (下方向)	下
g	上移到顶部
G	下移到底部
q/Q	退出
Space (空格)	暂停/播放
[	上一曲
]	下一曲
-/滚轮下	减小音量
=/滚轮上	加大音量
n/N/Enter (回车)	进入选中的菜单
b/B/Escape (退出)	返回上级菜单
w/W	退出并退出登录
p	切换播放方式
P	心动模式（仅在歌单中时有效）
r/R	重新渲染 UI	如果 UI 界面因为某种原因出现错乱，可以使用这个重新渲染
c/C	当前播放列表
v/V	快进 5 s / 10 s
x/X	快退 1 s / 5 s
,	喜欢当前播放歌曲
<	喜欢当前选中歌曲
.	当前播放歌曲移除出喜欢
>	当前选中歌曲移除出喜欢
“`	当前播放歌曲加入歌单
~	当前播放歌曲移出歌单
Tab	当前选中歌曲加入歌单
Shift+Tab	当前选中歌曲移出歌单
>	当前选中歌曲移除出喜欢
>	当前选中歌曲移除出喜欢
t	标记当前播放歌曲为不喜欢
T	标记当前选中歌曲为不喜欢
d	下载当前播放歌曲
D	下载当前选中歌曲
/	搜索当前列表
?	帮助信息
a	播放中歌曲的所属专辑
A	选中歌曲的所属专辑
s	播放中歌曲的所属歌手
S	选中歌曲的所属歌手
o	网页打开播放中歌曲
O	网页打开选中歌曲/专辑…
e	添加为下一曲播放
E	添加到播放列表末尾
\	从播放列表删除选中歌曲	仅在当前播放列表界面有效
;/:	收藏选中歌单
'/"	取消收藏选中歌单
u/U	清除音乐缓存

[全局快捷键]

默认不设置任何全局快捷键，如果需要请在配置文件中的global_hotkey下进行配置，例如：

[global_hotkey]
# 格式：键=功能 (https://github.com/go-musicfox/go-musicfox/blob/master/internal/ui/event_handler.go#L15)
ctrl+shift+space=toggle

因为Linux下开启全局快捷键需要安装比较多的依赖，可能你并不需要这个功能，所以Releases中的Linux二进制文件是不支持全局快捷键的

如果需要开启，请安装依赖后手动进行编译:

BUILD_TAGS=enable_global_hotkey make build

[配置文件]

配置文件路径为用户配置目录下的 go-musicfox.ini 文件，详细可参见配置示例。

用户配置目录路径：

macOS：$HOME/Library/Application Support/go-musicfox

Linux：$XDG_CONFIG_HOME/go-musicfox 或 $HOME/.config/go-musicfox

Windows：%AppData%\go-musicfox

你可以通过设置 MUSICFOX_ROOT 环境变量来自定义用户配置的存储位置

旧版本的 go-musicfox 的默认用户配置目录为 $HOME/.go-musicfox（*nix）或 %USERPROFILE%\.go-musicfox（Windows），升级到新版本时将自动迁移到上述的新路径