Что такое cliamp?
cliamp — это Winamp 2.x, пересобранный для терминала: редактор плейлиста, графический эквалайзер, визуализатор спектра и система тем вместо скинов, и всё это нарисовано текстом. Он играет локальные файлы (MP3, FLAC, OGG, WAV), интернет-радио и подкасты, а также стримит из Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, SoundCloud, NetEase и YouTube Music в одном интерфейсе. С ключом --daemon тот же двоичный файл превращается в плеер без интерфейса, управляемый через IPC-сокет: строка состояния, горячие клавиши и скрипты общаются с музыкой, которая уже играет.
⚡ Ключевые возможности cliamp
🎚️ Winamp в тексте
Редактор плейлиста, графический эквалайзер и классическая раскладка с пиковыми индикаторами, перерисованные псевдографикой. 20 встроенных тем, от dracula и nord до vantablack, меняют весь вид так же, как когда-то скины.
📡 Радио и стриминг
Каталог интернет-радио с избранным, плюс Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, SoundCloud, NetEase и YouTube Music за одним ключом --provider и интерактивным мастером cliamp setup.
📊 29 визуализаторов
Столбики спектра, осциллограф, стереополе, дождь из «Матрицы», пламя, фейерверк и другие — все питаются от одного и того же БПФ. cliamp vis переключает их на лету, а --low-power выключает всё, когда важен заряд батареи.
🎛️ Настоящие настройки звука
Параметрический эквалайзер с пресетами, скорость воспроизведения от 0,25× до 2×, сведение в моно, воспроизведение без пауз, переключение устройства вывода и явное управление частотой дискретизации, разрядностью и размером буфера.
🖥️ Демон без интерфейса и IPC
cliamp --daemon играет без TUI и отвечает на cliamp status, next или volume через свой сокет, а cliamp visstream отдаёт полосы визуализатора в NDJSON для Waybar, quickshell и всего, что умеет читать конвейер.
🧩 Lua-плагины в песочнице
API плагинов с хуками на события воспроизведения, раскладки клавиш, уведомления, HTTP и хранилище — и всё это в песочнице. Готовые примеры покрывают файл «сейчас играет», вебхуки и автоматическую эквализацию по жанру.
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 месяцев позади upstream, исправления безопасности сразу. Подключите его вместо репозитория выше:
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 ~/Музыка
# Или начать с каталога интернет-радио
cliamp --provider radio
# Настроить Spotify, Qobuz, Navidrome, Jellyfin, Emby или Plex
cliamp setup
# Дополнения bash и zsh идут в комплекте с пакетом
cliamp --help🎯 Примеры базового использования
Что-нибудь включить:
# Файл, папка или URL потока
cliamp ~/Музыка/альбомы/1997
cliamp https://stream.example.org/radio.mp3
# Сразу начать воспроизведение вперемешку
cliamp ~/Музыка --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 ~/Музыка
# Управлять запущенным плеером откуда угодно
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
- MPRIS через D-Bus: мультимедийные клавиши и виджет «сейчас играет» в вашем окружении управляют cliamp как любым другим плеером
- Waybar, quickshell и ваша оболочка: IPC-сокет и
cliamp visstreamпитают строки состояния и виджеты, а дополнения bash и zsh идут в этом пакете
🚀 Почему deb.griffo.io?
- Официальный Ubuntu: не пакетирует cliamp,
apt install cliampна обычной системе завершается ошибкой - go install: свежая версия, но это сборка с cgo на каждой машине, которой сначала нужны заголовки разработки ALSA, FLAC, Ogg и Vorbis
- Скрипт установки от upstream: удобно, но он кладёт двоичный файл в
~/.local/binв обход пакетного менеджера, аcliamp upgradeзатем заменяет его по собственному расписанию - deb.griffo.io: последняя версия с автоматическими обновлениями
- ✅ Единственный источник для apt: cliamp нет ни в архивах Debian, ни в архивах Ubuntu; этот репозиторий пакетирует официальную сборку upstream
- ✅ Стриминг ломается и чинится в upstream: музыкальные сервисы, с которыми говорит cliamp, меняются постоянно, поэтому версия этого месяца — это разница между работающим провайдером и неработающим
- ✅ Автоматические обновления: пакеты обновляются в течение нескольких часов после релиза upstream
- ✅ Полный пакет:
/usr/bin/cliamp, страница man, ярлык рабочего стола со значком приложения и дополнения bash и zsh - ✅ Честные зависимости: зависит от ALSA, рекомендует
ffmpegи предлагаетyt-dlp, так что минимальная установка остаётся минимальной - ✅ Две архитектуры: amd64 и arm64 — один и тот же пакет закрывает и ноутбук, и Raspberry Pi
- ✅ Мультидистрибутивность: работает на 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 - Терминальный файловый менеджер, чтобы найти альбом перед прослушиванием