Was ist cliamp?
cliamp ist Winamp 2.x, neu gebaut fürs Terminal: ein Playlist-Editor, ein grafischer Equalizer, ein Spektrum-Visualizer und ein Theme-System an Stelle der Skins, alles in Text gezeichnet. Es spielt lokale Dateien (MP3, FLAC, OGG, WAV), Internetradio und Podcasts und streamt aus Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, SoundCloud, NetEase und YouTube Music in einer einzigen Oberfläche. Mit --daemon wird dasselbe Binary zum Player ohne Oberfläche, gesteuert über einen IPC-Socket: Statusleiste, Tastenkürzel und Skripte reden dann mit der Musik, die bereits läuft.
⚡ Wichtige Funktionen von cliamp
🎚️ Winamp, in Text
Der Playlist-Editor, der grafische Equalizer und das klassische Layout mit Pegelanzeigen, neu gezeichnet mit Blockzeichen. 20 mitgelieferte Themes, von dracula und nord bis vantablack, ändern das ganze Aussehen, wie es früher die Skins taten.
📡 Radio und Streaming
Ein Internetradio-Katalog mit Favoriten, dazu Spotify, Qobuz, Navidrome, Jellyfin, Emby, Plex, SoundCloud, NetEase und YouTube Music hinter einer einzigen Option --provider und dem interaktiven Assistenten cliamp setup.
📊 29 Visualizer
Spektrumbalken, Oszilloskop, Stereofeld, Matrix-Regen, Flammen, Feuerwerk und mehr, alle aus derselben FFT gespeist. cliamp vis wechselt sie im Betrieb; --low-power schaltet alles ab, wenn der Akku zählt.
🎛️ Echte Audio-Regler
Ein parametrischer Equalizer mit Presets, Wiedergabegeschwindigkeit von 0,25× bis 2×, Mono-Downmix, lückenlose Wiedergabe, Umschalten des Ausgabegeräts und ausdrückliche Kontrolle über Abtastrate, Bittiefe und Puffergröße.
🖥️ Daemon ohne Oberfläche und IPC
cliamp --daemon spielt ohne TUI und beantwortet cliamp status, next oder volume über seinen Socket, während cliamp visstream die Visualizer-Bänder als NDJSON für Waybar, quickshell und alles andere ausgibt, das eine Pipe liest.
🧩 Lua-Plugins in der Sandbox
Eine Plugin-API mit Hooks für Wiedergabe-Ereignisse, Tastenbelegungen, Benachrichtigungen, HTTP und Speicher, alles in einer Sandbox. Die mitgelieferten Beispiele decken die „Läuft gerade“-Datei, Webhooks und automatische Entzerrung je Genre ab.
apt upgrade hält dich auf der neuesten Version.
📦 Installation von deb.griffo.io
Schritt 1: Repository hinzufügen
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 updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Für immer kostenlose Alternative. cliamp liegt auch im für immer kostenlosen Spiegel deb-free.griffo.io — ohne Konto, ohne Abo, höchstens 2 Monate hinter Upstream, Sicherheitsfixes sofort. Richte statt des Repositorys oben dieses ein:
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 updatesudo apt install extrepo
sudo extrepo enable griffo-free
sudo apt update🧩 Zur extrepo-Option. extrepo ist Debians eigenes Werkzeug für externe Repositories: Es legt die Sources-Datei an und installiert den Signaturschlüssel für dich, nachdem es ihn gegen signierte Metadaten geprüft hat. Dieses Repository ist dort als griffo registriert, der für immer kostenlose Spiegel als griffo-free. Unter Debian (bookworm, trixie, forky und sid) sind die Befehle oben damit die gesamte Einrichtung.
extrepo richtet nur die Sources-Datei und den Schlüssel ein; die Zugangsdaten eines Abos gehören weiterhin in /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu wird nicht abgedeckt, denn extrepo veröffentlicht Metadaten nur für Debian-Suites: dort nimmst du die Befehle mit sudo oder als root.
Schritt 2: cliamp installieren
# Neuestes cliamp installieren
sudo apt install cliamp
# ffmpeg ist empfohlen (weitere Formate und Streams),
# yt-dlp vorgeschlagen, für YouTube und YouTube Music
sudo apt install ffmpeg yt-dlp
# Installation prüfen
cliamp --version# Neuestes cliamp installieren
apt install cliamp
# ffmpeg ist empfohlen (weitere Formate und Streams),
# yt-dlp vorgeschlagen, für YouTube und YouTube Music
apt install ffmpeg yt-dlp
# Installation prüfen
cliamp --versionSchritt 3: das erste Stück
# Einen Musikordner im Player öffnen
cliamp ~/Musik
# Oder mit dem Internetradio-Katalog starten
cliamp --provider radio
# Spotify, Qobuz, Navidrome, Jellyfin, Emby oder Plex einrichten
cliamp setup
# bash- und zsh-Vervollständigungen liegen dem Paket bei
cliamp --help🎯 Grundlegende Anwendungsbeispiele
Etwas abspielen:
# Eine Datei, ein Ordner oder eine Stream-URL
cliamp ~/Musik/alben/1997
cliamp https://stream.example.org/radio.mp3
# Sofort losspielen, in zufälliger Reihenfolge
cliamp ~/Musik --auto-play --shuffle
# Eine gespeicherte Playlist, über ihren Namen
cliamp --playlist roadtrip
# Eine YouTube-Music-URL (braucht yt-dlp)
cliamp "https://music.youtube.com/watch?v=..."
# Was habe ich gehört?
cliamp historyAussehen und Klang:
# Themes auflisten und wechseln
cliamp theme list
cliamp theme tokyo-night
# Visualizer auflisten und wechseln
cliamp vis list
cliamp vis Stereo
# Equalizer-Presets und Wiedergabegeschwindigkeit
cliamp eq Rock
cliamp speed 1.25
# Ein Ausgabegerät wählen
cliamp --audio-device list
cliamp device "USB Audio"
# 80-Spalten-Layout für ein kleines Terminal
cliamp --compactOhne Oberfläche und per Skript:
# Ohne TUI laufen lassen und IPC bedienen
cliamp --daemon ~/Musik
# Den laufenden Player von überall steuern
cliamp toggle
cliamp next
cliamp volume -3
cliamp seek 90
cliamp status
# Eine Statusleiste mit Visualizer-Bändern speisen
cliamp visstream | jq -c .
# Lua-Plugins verwalten
cliamp plugins list🔧 Integrationen
cliamp setzt bewusst auf das auf, was dein System schon hat:
- ALSA: der Ton geht über
libasoundhinaus, daher die Paketabhängigkeit und daher läuft es auch auf einem nackten Server ohne Desktop-Sitzung - ffmpeg: empfohlen und für die Formate und Streams zuständig, die die eingebauten Decoder nicht abdecken
- yt-dlp: vorgeschlagen und nötig für die Wiedergabe von YouTube und YouTube Music
- MPRIS über D-Bus: die Medientasten deiner Tastatur und das „Läuft gerade“-Widget deines Desktops steuern cliamp wie jeden anderen Player
- Waybar, quickshell und deine Shell: der IPC-Socket und
cliamp visstreamspeisen Statusleisten und Widgets, und bash- und zsh-Vervollständigungen liegen diesem Paket bei
🚀 Warum deb.griffo.io?
- Offizielles Debian: paketiert cliamp nicht,
apt install cliampschlägt auf einem Standardsystem fehl - go install: aktuell, aber ein cgo-Build auf jeder Maschine, der zuerst die Entwicklungsheader von ALSA, FLAC, Ogg und Vorbis verlangt
- Das Upstream-Installationsskript: bequem, aber es legt ein Binary in
~/.local/binam Paketmanager vorbei ab, undcliamp upgradeersetzt dieses Binary danach nach eigenem Zeitplan - deb.griffo.io: neueste Version mit automatischen Updates
- ✅ Die einzige apt-Quelle: cliamp ist weder in den Debian- noch in den Ubuntu-Archiven; dieses Repository paketiert den offiziellen Upstream-Build
- ✅ Streaming geht kaputt und wird upstream repariert: die Musikdienste, mit denen cliamp spricht, ändern sich ständig, die Version dieses Monats entscheidet also darüber, ob ein Anbieter funktioniert oder nicht
- ✅ Automatische Updates: Pakete innerhalb von Stunden nach dem Upstream-Release aktualisiert
- ✅ Vollständiges Paket:
/usr/bin/cliamp, eine Manpage, ein Desktop-Eintrag mit Anwendungssymbol sowie bash- und zsh-Vervollständigungen - ✅ Ehrliche Abhängigkeiten: es hängt von ALSA ab, empfiehlt
ffmpegund schlägtyt-dlpvor, eine minimale Installation bleibt also minimal - ✅ Zwei Architekturen: amd64 und arm64, dasselbe Paket deckt Laptop und Raspberry Pi ab
- ✅ Multi-Distribution: läuft auf Bookworm, Trixie, Forky und Sid
- ✅ Einfache Wartung: Updates mit den üblichen apt-Befehlen
📦 Repository für den Paketbau
Die Debian-Pakete werden in diesem GitHub-Repository automatisch gebaut und gepflegt:
- 📻 cliamp-debian - Builds der neuesten Releases
🔗 Verwandte Pakete
Ebenfalls von deb.griffo.io verfügbar:
- termusic - Ein weiterer Musik- und Podcast-Player fürs Terminal, falls dir sein Layout lieber ist
- lowfi - Ein Lo-Fi-Radioplayer mit einem einzigen Befehl, wenn du gar keine Oberfläche willst
- yt-dlp - Der Downloader, den cliamp für YouTube und YouTube Music aufruft
- Yazi - Dateimanager fürs Terminal, um das Album zu finden, bevor du es abspielst