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] 需要满足以下条件：

1. go-musicfox >= v3.7.7
2. 下载和安装 LyricsX 的 go-musicfox 的 fork 版本
3. 在 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

{
  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

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

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

$ 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 （不推荐）或参照手动编译一节自行编译。

快捷键

应用内快捷键

全局快捷键

默认不设置任何全局快捷键，如果需要请在配置文件中的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

相关项目

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

感谢

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

• bubbletea
• beep
• musicbox
• NeteaseCloudMusicApi
• NeteaseCloudMusicApiWithGo
• gcli
• ...

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