Qu'est-ce que cliamp ?
cliamp, c'est Winamp 2.x refait pour le terminal : un éditeur de playlist, un égaliseur graphique, un visualiseur de spectre et un système de thèmes qui tient lieu de skins, le tout dessiné en texte. Il lit les fichiers locaux (MP3, FLAC, OGG, WAV), les radios en ligne et les podcasts, et diffuse depuis Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, SoundCloud, NetEase et YouTube Music dans une seule interface. Lancé avec --daemon, le même binaire devient un lecteur sans interface piloté par une socket IPC : votre barre d'état, vos raccourcis et vos scripts parlent alors à la musique déjà en cours.
⚡ Fonctionnalités clés de cliamp
🎚️ Winamp, en texte
L'éditeur de playlist, l'égaliseur graphique et la disposition classique avec vumètres, redessinés en caractères semi-graphiques. 20 thèmes intégrés, de dracula et nord à vantablack, changent toute l'apparence comme le faisaient les skins.
📡 Radio et streaming
Un catalogue de radios en ligne avec favoris, plus Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, SoundCloud, NetEase et YouTube Music derrière une seule option --provider et un assistant interactif cliamp setup.
📊 29 visualiseurs
Barres de spectre, oscilloscope, champ stéréo, pluie façon Matrix, flammes, feux d'artifice et bien d'autres, tous alimentés par la même FFT. cliamp vis les change à la volée ; --low-power coupe tout quand la batterie compte.
🎛️ De vrais réglages audio
Un égaliseur paramétrique avec presets, une vitesse de lecture de 0,25× à 2×, un mixage mono, une lecture sans blanc, le changement de périphérique de sortie et le contrôle explicite du taux d'échantillonnage, de la profondeur et du tampon.
🖥️ Démon sans interface et IPC
cliamp --daemon joue sans TUI et répond à cliamp status, next ou volume via sa socket, tandis que cliamp visstream émet les bandes du visualiseur en NDJSON pour Waybar, quickshell et tout ce qui sait lire un tube.
🧩 Plugins Lua en bac à sable
Une API de plugins avec des hooks pour les événements de lecture, les raccourcis, les notifications, HTTP et le stockage, le tout dans un bac à sable. Les exemples fournis couvrent le fichier « en cours de lecture », les webhooks et l'égalisation automatique par genre.
apt upgrade vous garde sur la dernière version.
📦 Installation depuis deb.griffo.io
Étape 1 : ajouter le dépôt
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🆓 Alternative gratuite pour toujours. cliamp est aussi dans le miroir gratuit pour toujours deb-free.griffo.io — sans compte, sans abonnement, au plus 2 mois derrière l'upstream, correctifs de sécurité immédiats. Ajoutez ce dépôt au lieu de celui ci-dessus :
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Étape 2 : installer cliamp
# Installer la dernière version de cliamp
sudo apt install cliamp
# ffmpeg est recommandé (formats supplémentaires et flux)
# et yt-dlp suggéré, pour YouTube et YouTube Music
sudo apt install ffmpeg yt-dlp
# Vérifier l'installation
cliamp --version# Installer la dernière version de cliamp
apt install cliamp
# ffmpeg est recommandé (formats supplémentaires et flux)
# et yt-dlp suggéré, pour YouTube et YouTube Music
apt install ffmpeg yt-dlp
# Vérifier l'installation
cliamp --versionÉtape 3 : première écoute
# Ouvrir un dossier de musique dans le lecteur
cliamp ~/Musique
# Ou démarrer sur le catalogue de radios en ligne
cliamp --provider radio
# Configurer Spotify, Qobuz, Navidrome, Jellyfin, Emby ou Plex
cliamp setup
# Les complétions bash et zsh sont fournies avec le paquet
cliamp --help🎯 Exemples d'utilisation de base
Lire quelque chose :
# Un fichier, un dossier ou l'URL d'un flux
cliamp ~/Musique/albums/1997
cliamp https://stream.example.org/radio.mp3
# Démarrer la lecture tout de suite, en aléatoire
cliamp ~/Musique --auto-play --shuffle
# Une playlist enregistrée, par son nom
cliamp --playlist roadtrip
# Une URL YouTube Music (nécessite yt-dlp)
cliamp "https://music.youtube.com/watch?v=..."
# Qu'ai-je écouté ?
cliamp historyL'allure et le son :
# Lister et changer de thème
cliamp theme list
cliamp theme tokyo-night
# Lister et changer de visualiseur
cliamp vis list
cliamp vis Stereo
# Presets d'égaliseur et vitesse de lecture
cliamp eq Rock
cliamp speed 1.25
# Choisir un périphérique de sortie
cliamp --audio-device list
cliamp device "USB Audio"
# Disposition en 80 colonnes pour un petit terminal
cliamp --compactSans interface et scripté :
# Tourner sans TUI, en servant l'IPC
cliamp --daemon ~/Musique
# Piloter le lecteur en cours depuis n'importe où
cliamp toggle
cliamp next
cliamp volume -3
cliamp seek 90
cliamp status
# Alimenter une barre d'état avec les bandes du visualiseur
cliamp visstream | jq -c .
# Gérer les plugins Lua
cliamp plugins list🔧 Intégrations
cliamp s'appuie volontairement sur ce que votre système a déjà :
- ALSA : le son sort par
libasound, d'où la dépendance du paquet et le fait qu'il fonctionne sur un serveur nu, sans session graphique - ffmpeg : recommandé, utilisé pour les formats et les flux que les décodeurs intégrés ne couvrent pas
- yt-dlp : suggéré, et nécessaire pour lire YouTube et YouTube Music
- MPRIS via D-Bus : les touches multimédia de votre clavier et le widget « en cours de lecture » de votre bureau pilotent cliamp comme n'importe quel autre lecteur
- Waybar, quickshell et votre shell : la socket IPC et
cliamp visstreamalimentent barres d'état et widgets, et les complétions bash et zsh sont fournies avec ce paquet
🚀 Pourquoi choisir deb.griffo.io ?
- Ubuntu officiel : n'empaquette pas cliamp :
apt install cliampéchoue sur un système standard - go install : à jour, mais c'est une compilation cgo sur chaque machine, qui réclame d'abord les en-têtes de développement ALSA, FLAC, Ogg et Vorbis
- Le script d'installation upstream : pratique, mais il dépose un binaire dans
~/.local/bindans le dos du gestionnaire de paquets, etcliamp upgraderemplace ensuite ce binaire selon son propre calendrier - deb.griffo.io : dernière version avec mises à jour automatiques
- ✅ La seule source apt : cliamp n'est ni dans les dépôts Debian ni dans ceux d'Ubuntu ; ce dépôt empaquette la version officielle upstream
- ✅ Le streaming casse et se répare upstream : les services musicaux auxquels cliamp parle changent sans arrêt, donc être sur la version du mois fait la différence entre un fournisseur qui marche et un qui ne marche pas
- ✅ Mises à jour automatiques : les paquets sont mis à jour quelques heures après chaque version upstream
- ✅ Paquet complet :
/usr/bin/cliamp, une page de manuel, un raccourci de bureau avec l'icône de l'application, et les complétions bash et zsh - ✅ Dépendances honnêtes : il dépend d'ALSA, recommande
ffmpeget suggèreyt-dlp: une installation minimale le reste - ✅ Deux architectures : amd64 et arm64, le même paquet couvre donc votre portable et votre Raspberry Pi
- ✅ Multi-distribution : fonctionne sur Ubuntu 22.04, 24.04, 25.10 et 26.04
- ✅ Maintenance simple : des mises à jour avec les commandes apt habituelles
📦 Dépôt de construction du paquet
Les paquets Ubuntu sont construits et maintenus automatiquement dans ce dépôt GitHub :
- 📻 cliamp-debian - Constructions des dernières versions
🔗 Paquets associés
Également disponibles sur deb.griffo.io :
- termusic - Un autre lecteur de musique et de podcasts pour le terminal, si vous préférez sa disposition
- lowfi - Un lecteur de radio lo-fi en une commande, quand vous ne voulez aucune interface
- yt-dlp - Le téléchargeur que cliamp appelle pour YouTube et YouTube Music
- Yazi - Gestionnaire de fichiers en terminal, pour retrouver l'album avant de le lire