Get Started

安装与首次运行

LoFiBox Zero 是 Linux-first 项目。当前第三方 APT 源用于 Debian 官方源收录前的安装和测试， 当前会发布 Debian trixie 的 amd64、适合 CM4/CM5 64-bit 系统的 arm64，以及适合 CM0/ARMv6 的 armhf 包。

1. 添加预览 APT 源

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://vicliu624.github.io/lofibox-apt/lofibox-archive-keyring.pgp \
  | sudo tee /etc/apt/keyrings/lofibox-archive-keyring.pgp >/dev/null

sudo tee /etc/apt/sources.list.d/lofibox.sources >/dev/null <<'EOF'
Types: deb
URIs: https://vicliu624.github.io/lofibox-apt/debian
Suites: trixie
Components: main
Architectures: amd64 arm64 armhf
Signed-By: /etc/apt/keyrings/lofibox-archive-keyring.pgp
EOF

sudo apt update
sudo apt install lofibox

2. 检查环境

首次安装后先跑 doctor。它会检查 XDG 路径、媒体根目录、播放后端、helper、cache、credential store 等基础环境。

lofibox version
lofibox doctor
lofibox doctor --json

3. 启动界面

4. 扫描媒体库并播放

本地库先配置媒体根目录，再扫描、搜索、播放或加入队列。

lofibox config set media.roots '["/home/vicliu/Music"]'
lofibox library scan --incremental
lofibox library status
lofibox search "Outkast"
lofibox play "/home/vicliu/Music/Outkast - Hey Ya!.mp3"
lofibox now --json

5. 远程库最小流程

远程媒体库分为 profile 配置、credential 凭据、remote 浏览与 stream resolve。凭据默认不要放在命令行参数里， 使用 stdin 形式避免进入 shell history 和进程列表。

lofibox credentials set jellyfin-home --password-stdin
lofibox source add jellyfin \
  --id jellyfin-home \
  --name "Home Jellyfin" \
  --base-url https://media.local:8096 \
  --username vicliu \
  --credential-ref jellyfin-home

lofibox source probe jellyfin-home
lofibox remote browse jellyfin-home /albums
lofibox remote search jellyfin-home "radiohead"

6. 切换 Remix 音效

Remix 可通过 GUI、TUI、WebUI 和 CLI 使用。它在 OFF、Radio、Tape、Vinyl 之间循环，是运行时音效， 不写回文件，也不重启当前曲目。

lofibox remix
lofibox eq show --json