cliamp：终端复古音乐播放器

项目简介

cliamp 是一款受 Winamp 启发的复古风格终端音乐播放器，用 Go 编写，基于 Bubbletea、Lip Gloss、Beep 和 go-librespot 构建。它在终端里提供完整播放体验：播放本地文件与网络流、接入多种在线音乐与自建媒体服务器、收听网络电台和播客，并配有频谱可视化、参数均衡器和播放列表。

官网：cliamp.stream　文档：whiterose.org.contextowl.co/docs/cliamp

手机上可以使用 cliamp mobile，这是原生 Android 客户端，支持电台、播客，并可连接与桌面版相同的服务器。

主要功能

• 本地与流媒体播放：播放目录、音频文件或 URL 流。
• 丰富的在线来源：YouTube、YouTube Music、SoundCloud、Mixcloud、Bilibili、Spotify、Qobuz、Tidal、Bandcamp 购买内容、网易云音乐、Yandex Music、小宇宙，以及 Navidrome、Lyrion、Plex、Jellyfin、Emby、Audiobookshelf。
• 网络电台：按 R 浏览 Radio Browser 目录中约 58,000 个电台；按 N 按国家浏览，也可打开完整标签索引，用 / 过滤，用 f 固定常听国家；回车即可把某国家或标签的电台载入为播放列表。
• 播客：运行 cliamp --provider podcast 浏览 Apple 前 100 节目与 19 个分类，用 / 搜索后回车，按 f 订阅，无需账号或 API key。
• 可视化与音效：频谱可视化、参数均衡器、播放列表。
• 遥控与无界面模式：可从脚本、状态栏或快捷键控制正在运行的实例，也支持 --daemon 无 TUI 运行；在 Linux 通过 MPRIS、macOS 通过 Now Playing、Windows 通过全局热键支持媒体键。
• Lua 插件：支持 Lua 插件扩展播放行为。

安装与使用

一键脚本

curl -fsSL https://cliamp.stream/install.sh | sh

Homebrew（会一并安装所需运行库）

brew install bjarneo/cliamp/cliamp

Arch Linux (AUR)

yay -S cliamp

Nix

nix run github:bjarneo/cliamp

Go

go install github.com/bjarneo/cliamp@latest

也可从 GitHub Releases 下载预编译二进制。

可选运行时依赖：

• ffmpeg：播放 AAC、ALAC、Opus、WMA
• yt-dlp：YouTube、YouTube Music、SoundCloud、Mixcloud、Bandcamp、Bilibili、网易云音乐

macOS 上执行 brew install ffmpeg yt-dlp，Linux 用发行版包管理器安装，Windows 需将两者放入 PATH。

快速开始

cliamp ~/Music                     # 播放一个目录
cliamp *.mp3 *.flac               # 播放文件
cliamp https://example.com/stream  # 播放 URL

按 Ctrl+K 查看全部快捷键。用交互式向导配置远程来源（Navidrome、Lyrion、Bandcamp、Plex、Jellyfin、Emby、Audiobookshelf、Spotify、Qobuz、Tidal、Mixcloud、YouTube Music、网易云音乐等），配置写入 ~/.config/cliamp/config.toml（Windows 为 %APPDATA%\cliamp\config.toml）：

cliamp setup

遥控示例

cliamp toggle
cliamp next
cliamp status --json

从源码构建

git clone https://github.com/bjarneo/cliamp.git
cd cliamp
make && make install

Linux 构建前需安装 ALSA 开发头文件（如 Debian/Ubuntu：sudo apt install libasound2-dev libflac-dev libvorbis-dev libogg-dev libmpg123-dev）。Windows 源码构建需要 CGO 与 MSYS2 MinGW64 工具链。

自定义电台可写入 ~/.config/cliamp/radios.toml。

注意事项

• macOS 预编译二进制动态链接 Homebrew 的 FLAC、Vorbis、Ogg、mpg123，需先执行 brew install flac libvorbis libogg mpg123，否则可能出现 Library not loaded: ... 报错。
• Linux 预编译二进制已静态链接上述编解码库；若使用 PipeWire 或 PulseAudio，还需安装桥接包（pipewire-alsa 或 pulseaudio-alsa / libasound2-plugins），否则会提示 audio output unavailable。
• Windows 从 Releases 下载 cliamp-windows-amd64.zip 解压使用，其中包含 Spotify 所需的编解码 DLL。
• 作者声明：使用本软件风险自负，作者不对使用造成的损失或问题负责。

---

本作品整理自 GitHub 开源项目 bjarneo/cliamp，原作者 @bjarneo，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。