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

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

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

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

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

# pacman -S go-musicfox

$ sudo dnf copr enable poesty/go-musicfox
$ sudo dnf install go-musicfox

$ sudo aptss install go-musicfox  //二进制包部署，同步较慢
$ sudo aptss install go-musicfox-git  //从源码编译，请保持网络通畅

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

{
  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

$ apt install go-musicfox

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

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

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

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

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

scoop install go-musicfox

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

注：需要 Go v1.22 及以上版本

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

Linux 需要 libFLAC-dev 开发套件

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

• APT (Debian, Ubuntu)

$ sudo apt install software-properties-common build-essential
$ sudo add-apt-repository ppa:longsleep/golang-backports //ubuntu默认go语言版本为1.18，需要更新到1.21
$ sudo apt install libflac-dev libasound2-dev golang-go

• 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下

• 请务必使用等宽字体，或将配置项 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 替换。

  遇到这种问题，你可以：

  • 找到已安装的新版 libFLAC.so，将其软链为libFLAC.so.8: ln -s /xxx/libFLAC.so /xxx/libFLAC.so.8 （推荐）
  • 自行安装 libflac8 （不推荐）
  • 参照手动编译一节自行编译。

  这里之所以使用 FLAC8，主要是为了兼容大部分系统，因为FLAC是向前兼容的（也就是说 ≥ 8 的FLAC都可以使用）

• wsl 环境下使用 beep 须安装 libasound2-plugins，见 issues

• XDG 支持

  自 #453 起，提供了完整的 XDG 支持，部分文件路径变更，见 XDG 支持说明

• 配置文件格式 自 #484 起，配置文件格式已由 INI 更换为 TOML

这些是程序核心框架提供的基础操作，其快捷键通常无法通过配置文件修改。

你可以在配置文件的 [keybindings] 部分修改这些操作的快捷键。

注意：

• 非字符快捷键大小写不敏感，如 shift+tab 等同 Shift+Tab，但 a 与 A 不同
• 多次绑定同一个键的行为是未定义的，以程序最后读取的为准
• 不可自定义操作 不可自定义且其使用的键也不可用于自定义
• 与歌曲、歌单等存在关联的操作现已默认添加至 actionOfSelected 及 actionOfPlayingSong

示例配置：

[keybindings]
# 取消所有默认键绑定（须自定义键以确保正常使用）
useDefaultKeyBindings = false

# 应用内快捷键
[keybindings.app]
# 将“下一首”改为 Alt+N
next = "alt+n"

# 为“帮助”额外添加 Ctrl+H
help = ["?","ctrl+h"]

# 取消“心动模式”的默认 P 键
intelligence = ""

# 将“显示当前播放列表”改为 Ctrl+P
curPlaylist = "ctrl+p"

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

[keybindings.global]
# 格式：键=功能
"ctrl+shift+space" = "toggle"

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

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

BUILD_TAGS=enable_global_hotkey make build

• 确保enableMouseEvent设置为true
• 详见 鼠标支持说明

分享文本的内容是完全可定制的，它由一套模板系统驱动（使用 text/template ，支持条件判断等高级用法）。

注意：

• 对于 episode（播客节目）类型，由于其本质也是一首“歌曲”，因此它同时拥有 Episode、Song 和 Album 的所有字段。其中 EpisodeName 和 SongName 的值是相同的。

不同类型的分享项目，其可用的信息字段也不同。例如，分享一首“歌曲”时，您可以同时获取到“歌曲信息”和它所属的“专辑信息”；而分享一个“歌手”时，则只有“歌手信息”。 不支持自定义模板名

[share]
song = "分享{{if .SongArtists}}{{.SongArtists}}的{{end}}单曲《{{.SongName}}》: {{.SongUrl}} (来自@网易云音乐)"