cliamp 在官方 Debian 软件源中吗？

不在, 官方 Debian 源没有打包 cliamp。本仓库目前是唯一的 apt 来源，提供 cliamp 1.63.2。

如何在 Debian 上安装最新版 cliamp？

按上方说明一次性添加 deb.griffo.io 仓库，然后运行：sudo apt install cliamp。之后通过常规的 sudo apt upgrade 获取新版本。

软件包是否有签名？如何构建？

每个软件包都使用仓库的 GPG 密钥（EA0F721D231FDD3A0A17B9AC7808B4DD62C41256）签名，并基于上游发布在公开的 GitHub 仓库中构建，任何人都可以审查。

支持哪些 Debian 版本？

Debian 12 Bookworm、Debian 13 Trixie、Forky 和 Sid。

在 Debian 上用 apt 安装 cliamp

来源	版本
deb.griffo.io	1.63.2 ✅
官方 Debian	🚫 未收录

← 返回首页

📌 要安装到特定发行版本？ Debian 12 (bookworm) · Debian 13 (trixie) · Debian 14 (forky) · Debian Sid

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 update

install -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

sudo apt install extrepo
sudo extrepo enable griffo
sudo 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 update

install -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

sudo apt install extrepo
sudo extrepo enable griffo-free
sudo apt update

免费镜像的工作方式 →

🧩 关于 extrepo 选项。 extrepo 是 Debian 官方用于管理第三方仓库的工具：它会替你写好 sources 文件并安装签名密钥，并在使用前先对照签名元数据校验该密钥。本仓库以 griffo 之名登记其中，永久免费镜像则为 griffo-free，因此在 Debian（bookworm、trixie、forky、sid）上，上面的命令就是全部配置。

extrepo 只负责 sources 文件和密钥，订阅凭据仍然要写入 /etc/apt/auth.conf.d/deb.griffo.io.conf。Ubuntu 不在覆盖范围内，因为 extrepo 只发布 Debian 各套件的元数据：在 Ubuntu 上请使用 sudo 或 root 的命令。

第 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？

📊 仓库对比：

官方 Debian：没有打包 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，同一个软件包同时覆盖笔记本和树莓派
✅ 多发行版：支持 Bookworm、Trixie、Forky 和 Sid
✅ 维护简单：使用标准 apt 命令更新

📦 软件包构建仓库

Debian 软件包在这个 GitHub 仓库中自动构建和维护：

📻 cliamp-debian - 最新版本构建

🔗 相关软件包

deb.griffo.io 同样提供：

termusic - 另一款终端音乐与播客播放器，如果你更喜欢它的布局
lowfi - 一条命令即可播放的 lo-fi 电台播放器，适合完全不想要界面的场景
yt-dlp - cliamp 播放 YouTube 和 YouTube Music 时调用的下载器
Yazi - 终端文件管理器，先找到专辑再播放

            🎯 非常适合： 通过 SSH 在没有桌面的机器上听自己的音乐库、让网络电台在 tmux 窗格里播一整天、用无界面守护进程驱动 Waybar 的“正在播放”小部件，以及在不放弃 FLAC、Navidrome 和 Spotify 的前提下找回 Winamp 的布局。
        

📻 在 Debian 上安装最新的 cliamp