边玩游戏，音乐不停。

以真实音乐库中的四张专辑为例：每张封面提供两种强调色和一种背景色调。

可以从列表中选择其他版本，以半秒为单位微调时间，或者只用离线歌词。此动画中的歌词是虚构的。

1. 在掌机上打开 PortMaster，在列表中找到 Audiofilus 并安装（它的页面）。
2. 或者从最新发布下载 audiofilus-portmaster.zip，解压到 ports 文件夹。
3. 在 Ports 中打开 Audiofilus，然后选择你的音乐文件夹。
4. 可选：把 yt-dlp 程序放进应用的 yt-dlp/ 文件夹，即可启用 YouTube Music。

在 muOS 上可以不用 PortMaster：把 audiofilus.muxapp 复制到 SD 卡的 ARCHIVE 文件夹，然后在 Archive Manager 中安装；它会出现在“应用程序”里。

在 Linux 或 Windows 电脑上，请看桌面版。

启动时会自动识别系统。翻盖、电源键、省电和音量都使用该系统自带的工具；在桌面上这些都会跳过。

用 Go 编写，掌机版不使用 cgo。解码库在运行时加载（如果系统中有的话）。

# with Docker, nothing else to install
git clone https://github.com/juanvillacortac/audiofilus
cd audiofilus
docker build --target dist --output dist .

# or with Go installed
./build.sh

两种方式都会在 dist/ 中生成桌面版和 arm64 程序，以及 PortMaster 压缩包。

curl -fsSL https://juanvillacortac.github.io/audiofilus/install.sh | sh

1. 将适用于 x86_64 或 aarch64 的最新版本下载到 ~/.local/share/audiofilus。
2. 把 audiofilus 链接到 ~/.local/bin。
3. 把 Audiofilus 添加到应用启动器。随时再运行一次即可更新；你的设置会保留。

或者手动安装

1. 从最新版本下载 audiofilus-linux-amd64.tar.gz（或 -arm64），解压到任意位置。
2. 在该文件夹中运行 ./audiofilus desktop install。它会把启动器条目和图标添加到 ~/.local/share。
3. 从应用启动器打开 Audiofilus。如果移动了文件夹，请重新执行第 2 步。

卸载：audiofilus quit; audiofilus desktop uninstall; rm -rf ~/.local/share/audiofilus ~/.local/bin/audiofilus*

Windows 10 或更高版本：下载 audiofilus-windows-amd64.zip，解压到任意位置并运行 audiofilus.exe。