¿Qué es cliamp?
cliamp es Winamp 2.x rehecho para la terminal: un editor de listas, un ecualizador gráfico, un visualizador de espectro y un sistema de temas que hace las veces de skins, todo dibujado en texto. Reproduce archivos locales (MP3, FLAC, OGG, WAV), radio por internet y pódcast, y transmite desde Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, SoundCloud, NetEase y YouTube Music en una sola interfaz. Con --daemon, el mismo binario se convierte en un reproductor sin interfaz gobernado por un socket IPC: tu barra de estado, tus atajos y tus scripts hablan con la música que ya está sonando.
⚡ Características principales de cliamp
🎚️ Winamp, en texto
El editor de listas, el ecualizador gráfico y la disposición clásica con vúmetros, redibujados con caracteres de bloque. 20 temas incluidos, de dracula y nord a vantablack, cambian todo el aspecto como hacían las skins.
📡 Radio y streaming
Un catálogo de radio por internet con favoritos, más Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, SoundCloud, NetEase y YouTube Music detrás de una sola opción --provider y del asistente interactivo cliamp setup.
📊 29 visualizadores
Barras de espectro, osciloscopio, campo estéreo, lluvia de Matrix, llamas, fuegos artificiales y más, todos alimentados por la misma FFT. cliamp vis los cambia en caliente; --low-power lo apaga todo cuando importa la batería.
🎛️ Controles de audio de verdad
Ecualizador paramétrico con presets, velocidad de reproducción de 0,25× a 2×, mezcla a mono, reproducción sin huecos, cambio de dispositivo de salida y control explícito de frecuencia de muestreo, profundidad de bits y búfer.
🖥️ Demonio sin interfaz e IPC
cliamp --daemon reproduce sin TUI y responde a cliamp status, next o volume por su socket, mientras cliamp visstream emite las bandas del visualizador como NDJSON para Waybar, quickshell y cualquier cosa que lea una tubería.
🧩 Plugins Lua en un sandbox
Una API de plugins con hooks para eventos de reproducción, atajos, notificaciones, HTTP y almacenamiento, todo dentro de un sandbox. Los ejemplos incluidos cubren el archivo de «sonando ahora», webhooks y ecualización automática por género.
apt upgrade te mantiene en la última versión.
📦 Instalación desde deb.griffo.io
Paso 1: añadir el repositorio
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🆓 Alternativa gratis para siempre. cliamp también está en el espejo gratis para siempre deb-free.griffo.io: sin cuenta, sin suscripción, como máximo 2 meses por detrás del upstream y correcciones de seguridad inmediatas. Añade ese repositorio en lugar del anterior:
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 updatePaso 2: instalar cliamp
# Instalar el último cliamp
sudo apt install cliamp
# ffmpeg es recomendado (formatos adicionales y flujos)
# y yt-dlp sugerido, para YouTube y YouTube Music
sudo apt install ffmpeg yt-dlp
# Verificar la instalación
cliamp --version# Instalar el último cliamp
apt install cliamp
# ffmpeg es recomendado (formatos adicionales y flujos)
# y yt-dlp sugerido, para YouTube y YouTube Music
apt install ffmpeg yt-dlp
# Verificar la instalación
cliamp --versionPaso 3: primera reproducción
# Abrir una carpeta de música en el reproductor
cliamp ~/Música
# O empezar por el catálogo de radio por internet
cliamp --provider radio
# Configurar Spotify, Qobuz, Navidrome, Jellyfin, Emby o Plex
cliamp setup
# El paquete incluye las completaciones de bash y zsh
cliamp --help🎯 Ejemplos de uso básico
Reproducir cosas:
# Un archivo, una carpeta o la URL de un flujo
cliamp ~/Música/albums/1997
cliamp https://stream.example.org/radio.mp3
# Empezar a sonar ya, en aleatorio
cliamp ~/Música --auto-play --shuffle
# Una lista guardada, por su nombre
cliamp --playlist roadtrip
# Una URL de YouTube Music (necesita yt-dlp)
cliamp "https://music.youtube.com/watch?v=..."
# ¿Qué he escuchado?
cliamp historyAspecto y sonido:
# Listar y cambiar de tema
cliamp theme list
cliamp theme tokyo-night
# Listar y cambiar de visualizador
cliamp vis list
cliamp vis Stereo
# Presets del ecualizador y velocidad de reproducción
cliamp eq Rock
cliamp speed 1.25
# Elegir un dispositivo de salida
cliamp --audio-device list
cliamp device "USB Audio"
# Disposición de 80 columnas para una terminal pequeña
cliamp --compactSin interfaz y con scripts:
# Ejecutar sin TUI, sirviendo IPC
cliamp --daemon ~/Música
# Controlar el reproductor en marcha desde cualquier sitio
cliamp toggle
cliamp next
cliamp volume -3
cliamp seek 90
cliamp status
# Alimentar una barra de estado con las bandas del visualizador
cliamp visstream | jq -c .
# Gestionar los plugins Lua
cliamp plugins list🔧 Integraciones
cliamp se apoya a propósito en lo que tu sistema ya tiene:
- ALSA: el audio sale por
libasound, de ahí la dependencia del paquete y que funcione en un servidor pelado, sin sesión de escritorio - ffmpeg: recomendado, y usado para los formatos y flujos que los decodificadores integrados no cubren
- yt-dlp: sugerido, y necesario para reproducir YouTube y YouTube Music
- MPRIS sobre D-Bus: las teclas multimedia de tu teclado y el widget de «sonando ahora» de tu escritorio controlan cliamp como a cualquier otro reproductor
- Waybar, quickshell y tu shell: el socket IPC y
cliamp visstreamalimentan barras de estado y widgets, y este paquete incluye las completaciones de bash y zsh
🚀 ¿Por qué elegir deb.griffo.io?
- Ubuntu oficial: no empaqueta cliamp,
apt install cliampfalla en un sistema estándar - go install: actual, pero es una compilación cgo en cada máquina, que antes exige las cabeceras de desarrollo de ALSA, FLAC, Ogg y Vorbis
- El script de instalación upstream: cómodo, pero deja un binario en
~/.local/bina espaldas del gestor de paquetes, y luegocliamp upgradereemplaza ese binario a su propio ritmo - deb.griffo.io: última versión con actualizaciones automáticas
- ✅ La única fuente apt: cliamp no está ni en los archivos de Debian ni en los de Ubuntu; este repositorio empaqueta la compilación oficial upstream
- ✅ El streaming se rompe y se arregla upstream: los servicios de música con los que habla cliamp cambian constantemente, así que estar en la versión de este mes marca la diferencia entre que un proveedor funcione o no
- ✅ Actualizaciones automáticas: paquetes actualizados pocas horas después de cada versión upstream
- ✅ Paquete completo:
/usr/bin/cliamp, una página de manual, un lanzador de escritorio con el icono de la aplicación y las completaciones de bash y zsh - ✅ Dependencias honestas: depende de ALSA, recomienda
ffmpegy sugiereyt-dlp, así que una instalación mínima sigue siendo mínima - ✅ Dos arquitecturas: amd64 y arm64, el mismo paquete cubre tu portátil y tu Raspberry Pi
- ✅ Multidistribución: funciona en Ubuntu 22.04, 24.04, 25.10 y 26.04
- ✅ Mantenimiento fácil: comandos apt estándar para actualizar
📦 Repositorio de construcción del paquete
Los paquetes de Ubuntu se construyen y mantienen automáticamente en este repositorio de GitHub:
- 📻 cliamp-debian - Compilaciones de las últimas versiones
🔗 Paquetes relacionados
También disponibles en deb.griffo.io:
- termusic - Otro reproductor de música y pódcast para la terminal, si prefieres su disposición
- lowfi - Un reproductor de radio lo-fi de un solo comando, para cuando no quieres interfaz alguna
- yt-dlp - El descargador al que llama cliamp para YouTube y YouTube Music
- Yazi - Gestor de archivos en terminal para encontrar el álbum antes de reproducirlo