/go-musicfox

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

Primary LanguageGoMIT LicenseMIT

go-musicfox

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

UI基于 charmbracelet/bubbletea ，做了一些定制

GitHub repo size GitHub Last Tag GitHub last commit GitHub All Releases

GitHub stars GitHub forks

logo

(The icon is based on kitty-icon)

预览

1. 启动

启动界面

2. 主界面

主界面

3. 通知

通知

4. 登录

登录界面

5. 搜索

搜索界面

6. lastfm授权

lastfm

7. Mac NowPlaying

NowPlaying

8. UnblockNeteaseMusic

UNM

9. MacOS歌词显示

LyricsX

  1. 需要下载安装LyricsX go-musicfox Fork版本
  2. 且go-musicfox >= v3.7.7
  3. 在LyricsX设置中，打开使用系统正在播放的应用

安装

请务必使用等宽字体，或将配置doubleColumn设为false，否则双列显示很乱

Mac原生Terminal及Windows的cmd不做兼容处理

Mac推荐使用Iterm2或Kitty

Linux推荐Kitty

Windows推荐使用Windows Terminal，UI及体验好很多

Mac

1. 使用Homebrew安装

brew install anhoder/go-musicfox/go-musicfox

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

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

2. 直接下载

下载Mac可执行文件: https://github.com/go-musicfox/go-musicfox/releases/latest

Linux

1. 使用Homebrew安装

brew install anhoder/go-musicfox/go-musicfox

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

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

2. Arch Linux可使用AUR安装：

#编译
paru -S go-musicfox
#二进制包
paru -S go-musicfox-bin

3. Gentoo Linux可使用gentoo-zh overlay安装：

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

4. NixOS可从Nixpkgs安装：

安装到本地profile：

nix-env -iA nixos.go-musicfox

临时安装：

nix-shell -p go-musicfox

安装到Configuration.nix（推荐）：

# configuration
environment.systemPackages = [
  pkgs.go-musicfox
];

# 或者home manager
home.packages = [
  pkgs.go-musicfox
];

5. Void Linux可使用 void-packages-zh 安装：

具体安装请看这里。

6. 直接下载

下载Linux可执行文件: https://github.com/go-musicfox/go-musicfox/releases/latest

Windows

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

1. scoop安装

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

scoop install go-musicfox

2. 直接下载

下载Windows可执行文件: https://github.com/go-musicfox/go-musicfox/releases/latest

手动编译

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

> go mod download

(Linux编译前需要安装flac)

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

使用

$ musicfox
按键 作用 备注
h/H/LEFT 左
l/L/RIGHT 右
k/K/UP 上
j/J/DOWN 下
g 上移到顶部
G 下移到底部
q/Q 退出
space 暂停/播放
[ 上一曲
] 下一曲
-/滚轮下 减小音量
=/滚轮上 加大音量
n/N/ENTER 进入选中的菜单
b/B/ESC 返回上级菜单
w/W 退出并退出登录
p 切换播放方式
P 心动模式(仅在歌单中时有效)
r/R 重新渲染UI 如果UI界面因为某种原因出现错乱，可以使用这个重新渲染
c/C 当前播放列表
v/V 快进5s/10s
x/X 快退1s/5s
, 喜欢当前播放歌曲
< 喜欢当前选中歌曲
. 当前播放歌曲移除出喜欢
> 当前选中歌曲移除出喜欢
t 标记当前播放歌曲为不喜欢
T 标记当前选中歌曲为不喜欢
d 下载当前播放歌曲
D 下载当前选中歌曲
/ 搜索当前列表
? 帮助信息
a 播放中歌曲的所属专辑
A 选中歌曲的所属专辑
s 播放中歌曲的所属歌手
S 选中歌曲的所属歌手
o 网页打开播放中歌曲
O 网页打开选中歌曲/专辑...
;/: 收藏选中歌单
'/" 取消收藏选中歌单

配置文件

配置文件路径为用户目录下的.go-musicfox/go-musicfox.ini，相关配置：

详细配置

相关项目

  1. anhoder/bubbletea: 基于 bubbletea 进行部分定制
  2. anhoder/bubbles: 基于 bubbles 进行部分定制
  3. anhoder/netease-music: fork自 NeteaseCloudMusicApiWithGo ，在原项目的基础上去除API功能，只保留service、util作为一个独立的包，方便在其他go项目中调用

感谢

感谢以下项目及其贡献者们（但不限于）：

感谢JetBrains Open Source为项目提供免费的 IDE 授权

Star History Chart