📌 要安装到特定发行版本？ Ubuntu 22.04 (jammy) · Ubuntu 24.04 (noble) · Ubuntu 25.10 (questing) · Ubuntu 26.04 (resolute)
cliamp 是什么？
cliamp 是为终端重做的 Winamp 2.x：播放列表编辑器、图形均衡器、频谱可视化器，以及代替皮肤的主题系统，全部用字符绘制。它可以播放本地文件（MP3、FLAC、OGG、WAV）、网络电台和播客，也能在同一个界面里从 Spotify、Qobuz、Navidrome、Jellyfin、Emby、Plex、SoundCloud、网易云音乐和 YouTube Music 流式播放。加上 --daemon，同一个可执行文件就变成没有界面的播放器，通过 IPC 套接字接受指令：状态栏、快捷键和脚本都能直接和正在播放的音乐对话。
🚀 为什么最新版本很重要： cliamp 的大部分代码是与不断变动的服务对接的粘合层：Spotify、Qobuz、SoundCloud、网易云音乐和 YouTube Music 都会毫无预警地改动接口，本月坏掉的服务会在本月的版本里修好，而不是在去年的构建里。这正是 cliamp 每周发布多个版本的原因。Debian 和 Ubuntu 都没有打包它，所以在这里用最新构建不是锦上添花，而是通过 apt 安装它的唯一途径。
⚡ cliamp 的主要特性
🎚️ 文字版的 Winamp
播放列表编辑器、图形均衡器和带峰值表的经典布局，用制表字符重新绘制。从 dracula、nord 到 vantablack 的 20 款内置主题，像当年的皮肤一样改变整体外观。
📡 电台与流媒体
带收藏功能的网络电台目录，外加 Spotify、Qobuz、Navidrome、Jellyfin、Emby、Plex、SoundCloud、网易云音乐和 YouTube Music，统一由一个 --provider 选项和交互式向导 cliamp setup 管理。
📊 29 种可视化效果
频谱柱、示波器、立体声场、矩阵雨、火焰、烟花等等，全部由同一套 FFT 驱动。cliamp vis 可在运行时切换；在意续航时用 --low-power 直接关掉。
🎛️ 真正的音频控制
带预设的参量均衡器、0.25 倍到 2 倍的播放速度、单声道混音、无缝播放、输出设备切换，以及采样率、位深和缓冲区大小的显式控制。
🖥️ 无界面守护进程与 IPC
cliamp --daemon 不启动 TUI 也能播放，并通过套接字响应 cliamp status、next 或 volume；cliamp visstream 则以 NDJSON 输出可视化频段，供 Waybar、quickshell 以及任何能读管道的程序使用。
🧩 沙箱中的 Lua 插件
插件 API 提供播放事件、按键映射、通知、HTTP 和存储等钩子，且全部运行在沙箱内。自带示例涵盖“正在播放”文件、Webhook 和按流派自动均衡。
🚀 始终领先于官方软件源： Debian 和 Ubuntu 在发行版发布时会冻结软件包版本。本仓库通常在数小时内发布新的上游版本。只需
apt upgrade 就能保持在最新版本。
📦 从 deb.griffo.io 安装
运行命令
第 1 步：添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update🆓 永久免费的替代方案。 cliamp 也在永久免费的镜像 deb-free.griffo.io 中 — 无需账号、无需订阅，最多落后上游 2 个月，安全修复立即发布。可以改用该仓库替代上面的仓库：
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
apt update第 2 步：安装 cliamp
# 安装最新的 cliamp
sudo apt install cliamp
# ffmpeg 为推荐依赖（额外格式与流处理），
# yt-dlp 为建议依赖，用于 YouTube 和 YouTube Music
sudo apt install ffmpeg yt-dlp
# 验证安装
cliamp --version# 安装最新的 cliamp
apt install cliamp
# ffmpeg 为推荐依赖（额外格式与流处理），
# yt-dlp 为建议依赖，用于 YouTube 和 YouTube Music
apt install ffmpeg yt-dlp
# 验证安装
cliamp --version第 3 步：第一次播放
# 在播放器中打开一个音乐文件夹
cliamp ~/Music
# 或者从网络电台目录开始
cliamp --provider radio
# 配置 Spotify、Qobuz、Navidrome、Jellyfin、Emby 或 Plex
cliamp setup
# 软件包自带 bash 和 zsh 补全
cliamp --help🎯 基本使用示例
播放内容：
# 文件、文件夹或流地址
cliamp ~/Music/albums/1997
cliamp https://stream.example.org/radio.mp3
# 立即以随机顺序开始播放
cliamp ~/Music --auto-play --shuffle
# 按名称加载已保存的播放列表
cliamp --playlist roadtrip
# 一个 YouTube Music 链接（需要 yt-dlp）
cliamp "https://music.youtube.com/watch?v=..."
# 我都听过什么？
cliamp history外观与声音：
# 列出并切换主题
cliamp theme list
cliamp theme tokyo-night
# 列出并切换可视化效果
cliamp vis list
cliamp vis Stereo
# 均衡器预设与播放速度
cliamp eq Rock
cliamp speed 1.25
# 选择输出设备
cliamp --audio-device list
cliamp device "USB Audio"
# 适合小终端的 80 列布局
cliamp --compact无界面与脚本化：
# 不启动 TUI，提供 IPC 服务
cliamp --daemon ~/Music
# 从任何地方控制正在运行的播放器
cliamp toggle
cliamp next
cliamp volume -3
cliamp seek 90
cliamp status
# 把可视化频段送给状态栏
cliamp visstream | jq -c .
# 管理 Lua 插件
cliamp plugins list🔧 工具集成
cliamp 有意建立在系统已有的组件之上：
- ALSA：音频通过
libasound输出，这也是软件包依赖它的原因，因此在没有桌面会话的裸服务器上同样可用 - ffmpeg：推荐依赖，用于内置解码器覆盖不到的格式和流
- yt-dlp：建议依赖，播放 YouTube 和 YouTube Music 时必需
- 基于 D-Bus 的 MPRIS：键盘上的媒体键和桌面的“正在播放”小部件可以像控制其他播放器一样控制 cliamp
- Waybar、quickshell 与你的 shell：IPC 套接字和
cliamp visstream驱动状态栏与小部件，本软件包还自带 bash 和 zsh 补全
🚀 为什么选择 deb.griffo.io？
📊 仓库对比：
- 官方 Ubuntu：没有打包 cliamp，在原始系统上
apt install cliamp会失败 - go install：版本够新，但需要在每台机器上进行 cgo 构建，并且要先准备 ALSA、FLAC、Ogg 和 Vorbis 的开发头文件
- 上游安装脚本：方便，但它绕过包管理器把可执行文件放进
~/.local/bin，之后cliamp upgrade还会按自己的节奏替换该文件 - deb.griffo.io：最新版本，自动更新
- ✅ 唯一的 apt 来源：cliamp 既不在 Debian 也不在 Ubuntu 的软件源中；本仓库打包的是官方上游构建
- ✅ 流媒体会坏，也在上游修好：cliamp 对接的音乐服务一直在变，用不用本月的版本，直接决定某个服务能不能用
- ✅ 自动更新：上游发布后数小时内更新软件包
- ✅ 完整的软件包：
/usr/bin/cliamp、man 手册页、带应用图标的桌面入口，以及 bash 和 zsh 补全 - ✅ 诚实的依赖：依赖 ALSA，推荐
ffmpeg，建议yt-dlp，最小安装依然保持最小 - ✅ 两种架构：amd64 与 arm64，同一个软件包同时覆盖笔记本和树莓派
- ✅ 多发行版：支持 Ubuntu 22.04、24.04、25.10 和 26.04
- ✅ 维护简单：使用标准 apt 命令更新
📦 软件包构建仓库
Ubuntu 软件包在这个 GitHub 仓库中自动构建和维护：
- 📻 cliamp-debian - 最新版本构建
🔗 相关软件包
deb.griffo.io 同样提供：
- termusic - 另一款终端音乐与播客播放器，如果你更喜欢它的布局
- lowfi - 一条命令即可播放的 lo-fi 电台播放器，适合完全不想要界面的场景
- yt-dlp - cliamp 播放 YouTube 和 YouTube Music 时调用的下载器
- Yazi - 终端文件管理器，先找到专辑再播放
🎯 非常适合： 通过 SSH 在没有桌面的机器上听自己的音乐库、让网络电台在 tmux 窗格里播一整天、用无界面守护进程驱动 Waybar 的“正在播放”小部件，以及在不放弃 FLAC、Navidrome 和 Spotify 的前提下找回 Winamp 的布局。