go-musicfox | 另一个Spotify版 Spotifox

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

UI 基于 charmbracelet/bubbletea 进行了部分定制

(The icon is based on kitty-icon)

预览

1. 启动

2. 主界面

3. 通知

4. 登录

5. 搜索

6. Last.fm 授权

7. macOS NowPlaying

8. UnblockNeteaseMusic

9. macOS 歌词显示

Important

需要满足以下条件：

go-musicfox >= v3.7.7
下载和安装 LyricsX 的 go-musicfox 的 fork 版本
在 LyricsX 设置中，打开使用系统正在播放的应用

安装

macOS

1. 通过 Homebrew 安装

$ brew install anhoder/go-musicfox/go-musicfox  // 指定 --head 使用master代码编译安装

如果你之前安装过 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

1. flake support

下面是一个在nixos配置中使用它的例子

{
  description = "My configuration";

  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    go-musicfox.url = "github:go-musicfox/go-musicfox";
  };

  outputs = { nixpkgs, go-musicfox, ... }:
    {
      nixosConfigurations = {
        hostname = nixpkgs.lib.nixosSystem
          {
            system = "x86_64-linux";
            modules = [
              {
                nixpkgs.overlays = [ go-musicfox.overlays.default ];
                environment.systemPackages = with pkgs;[
                  go-musicfox
                ];
              }
            ];
          };
      };
    };
}

临时运行:

$ nix run github:go-musicfox/go-musicfox

2. 配置 configuration.nix 或使用 Home Manager（推荐）

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

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

3. 从 Nixpkgs 安装

安装到本地 profile：

$ nix-env -iA nixos.go-musicfox

临时安装：

$ nix-shell -p go-musicfox

Void Linux

从 void-packages-zh 安装。

2. 通过 Homebrew 安装

$ brew install anhoder/go-musicfox/go-musicfox  // 指定 --head 使用master代码编译安装

如果你之前安装过 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.21 及以上版本

前往下载 Go 页面选择适合你的 Go 安装包体。

在 Linux 上编译

Linux 需要 libFLAC-dev 开发套件

请根据你的发行版，选择适合你的安装命令：

APT (Debian, Ubuntu)

$ sudo apt install -y libflac-dev

pacman (Arch)

$ sudo pacman -S flac

DNF (Fedora)

$ sudo dnf install flac-devel

其他发行版请根据相应文档寻找 libflac-dev 开发套件安装说明。

开始编译

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

$ go mod download

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

使用

$ musicfox

注意事项

Important

请务必使用等宽字体，或将配置项 doubleColumn 设为 false，否则双列显示排版可能会混乱
如果在使用时出现莫名奇妙的光标移动、切歌或暂停等现象，请将配置项 enableMouseEvent 设置为 false
本应用不对 macOS 原生终端和 Windows 的命令提示符（CMD）做兼容处理（#99）

macOS 用户推荐使用 iTerm2 或 Kitty

Linux 用户推荐使用 Kitty

Windows 用户推荐使用 Windows Terminal，使用体验更佳
如果在执行文件时遇到以下错误，说明你的操作系统内不包含 libFLAC.so.8 。
```
./musicfox: error while loading shared libraries: libFLAC.so.8: cannot open shared object file: No such file or directory
```
例如 Ubuntu 23.10 及它的衍生版系列，libFLAC.so.12 已经将 libFLAC.so.8 替换。

遇到这种问题，你可以自行安装 libflac8 （不推荐）或参照手动编译一节自行编译。

快捷键

应用内快捷键

按键	作用	备注
`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`	清除音乐缓存
`ctrl`+`u`	上一页
`ctrl`+`d`	下一页

全局快捷键

默认不设置任何全局快捷键，如果需要请在配置文件中的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），升级到新版本时将自动迁移到上述的新路径

CHANGELOG

See CHANGELOG.md

感谢

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

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

oobcc/go-musicfox

go-musicfox | 另一个Spotify版 Spotifox

预览

1. 启动

2. 主界面

3. 通知

4. 登录

5. 搜索

6. Last.fm 授权

7. macOS NowPlaying

8. UnblockNeteaseMusic

9. macOS 歌词显示

安装

macOS

1. 通过 Homebrew 安装

2. 直接下载

Linux

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

Arch Linux

从 AUR 安装

从 archlinuxcn 安装

Gentoo Linux

从 gentoo-zh Overlay 安装

NixOS

Void Linux

2. 通过 Homebrew 安装

3. 直接下载

Windows

1. 通过 scoop 安装

2. 直接下载

手动编译

在 Linux 上编译

开始编译

使用

注意事项

快捷键

应用内快捷键

全局快捷键

配置文件

CHANGELOG

相关项目

感谢

从 `archlinuxcn` 安装