CLIAMP — Terminal Music Player
Terminal music player
cliamp
Winamp for your shell.
Playlists, a 10-band EQ, visualizers, synced lyrics, remote control, and a Lua plugin system — streaming from Spotify, Qobuz, YouTube Music, Plex, Jellyfin, Emby, Navidrome, and 30,000+ radio stations.
Install→<br>Source↗
cliamp<br>--provider radio
▶❚❚◌<br>tty1
C L I A M P[Playlist]
♫Lofi Hip Hop Radio
00:00 / 00:00
■ Stopped (click to play)<br>◌ Buffering…<br>● Streaming
━━━━━━━━━━━━━━━━━━━━<br>STREAMING<br>━━━━━━━━━━━━━━━━━━━━
EQ<br>[Rock]<br>+5 +4 +2 -1 -2 +2 +4 +5 +5 +5
VOL
+0dB
SRC<br>[Radio]<br>1/9
▸─ Playlist ──<br>[Shuffle]<br>[Repeat: Off]<br>[1/11]<br>──
▶ 1. Lofi Hip Hop Radio
▶ 2. EDM Pulse
▶ 3. Synthwave Nights
▶ 4. NCS Radio
▶ 5. NCS House
▶ 6. NCS Dubstep
▶ 7. NCS Drum & Bass
▶ 8. NCS Trap
▶ 9. NCS Phonk
▶10. NCS Pop
▶11. NCS Chill
↑↓ Scroll<br>Enter Play<br>Spc ▶❚❚<br>f Fav<br>Tab Focus<br>? Keys
SPD [1x]<br>↓ 0.7 MB 32 KB/s
Click a station above to tune in live — right here in your browser.
$ cliamp https://radio.cliamp.stream/lofi/stream.pls
MP3 · FLAC · OGG · OPUS · WAV · AAC · ALAC · Spotify · Qobuz · YouTube · Plex · Jellyfin · Emby · Navidrome · SoundCloud · NetEase · Bandcamp · Bilibili · RSS / Podcasts · 30k+ Radio Stations · ICY metadata · MPRIS · Lua plugins
01demo.mp4
02install.sh
Direct
$ curl -fsSL …/install.sh | sh<br>COPIED
Homebrew
$ brew install bjarneo/cliamp/cliamp<br>COPIED
Arch (AUR)
$ yay -S cliamp<br>COPIED
Nix
$ nix run github:bjarneo/cliamp<br>COPIED
Go
$ go install github.com/bjarneo/cliamp@latest<br>COPIED
Or build from source — see the README. Windows builds are available from Releases; when HOME is unset, config lives under %APPDATA%\cliamp.
Next step · configure providers
Run the setup wizard
An interactive TUI walks you through Navidrome, Plex, Jellyfin, Emby, Spotify, Qobuz, NetEase, and YouTube Music. It links to each provider's credential page, validates the connection, and writes the right block to your config file.
Setup
$ cliamp setup<br>COPIED
03sources
Stream from everywhere. Every provider runs through the same playlist, EQ, visualizer, and lyrics pipeline — your config follows you across services. Run cliamp setup for an interactive wizard that walks you through Navidrome, Plex, Jellyfin, Emby, Audiobookshelf, Spotify, Qobuz, NetEase, and YouTube Music.
OAuth · cached<br>Spotify<br>Stream your Premium library. Bring your own developer client_id for a private Web API quota; playback is authorized separately. Search with Ctrl+F; Development Mode paging is automatic. Pre-built Windows releases include Spotify support.
OAuth · lossless<br>Qobuz<br>Opt-in: set [qobuz] enabled = true. Stream lossless FLAC up to 24-bit/192kHz from your subscription. Browse favorites & playlists, search with Ctrl+F. Sign in once via OAuth in your browser.
yt-dlp<br>YouTube<br>Search videos with Ctrl+F, then play, append, or queue from a results list.
Cookies · OAuth<br>YT Music<br>Browse your playlists and Liked Music directly via browser cookies (zero OAuth setup) or custom Google Cloud credentials. Set cookies_from in your config.
Media server<br>Plex<br>Browse albums and stream from your Plex Media Server.
Media server<br>Jellyfin<br>Artists, albums, tracks — buffered gapless playback.
Media server<br>Emby<br>Browse your Emby music library with API key or username/password auth.
Subsonic API<br>Navidrome<br>Browse your self-hosted library with synced lyrics.
Media server<br>Audiobookshelf<br>Audiobooks and podcasts from your own server, with synced listening position and resume.
Provider · yt-dlp<br>SoundCloud<br>Opt-in: set [soundcloud] enabled = true. Search with Ctrl+F, browse curated genre playlists, or add user for your profile. cookies_from unlocks Go+ tracks via your browser session.
Provider · yt-dlp<br>NetEase<br>Opt-in: run cliamp setup after signing in at music.163.com, then choose your browser. Browse liked songs, account playlists, saved playlists, and charts with browser-cookie playback.
yt-dlp<br>Bandcamp<br>Paste any Bandcamp URL and it just plays.
yt-dlp<br>Bilibili<br>Audio tracks from Bilibili videos via yt-dlp.
30k+ stations<br>Radio<br>Browse stations by country, tag, or name. ICY metadata.
RSS feeds<br>Podcasts<br>Pass any podcast RSS URL and listen in your terminal.
Local<br>Files<br>MP3, FLAC, OGG, Opus, WAV, AAC, ALAC, WMA. ID3 tags read.
NetEase Cloud Music
Browser-session setup
Sign in at music.163.com, then run cliamp setup. Choose NetEase Cloud Music, pick the browser you used, and the wizard validates the session before writing config.
[netease]<br>enabled = true<br>cookies_from = "chrome"<br>user_id = "your-account-user-id"<br>After setup, press M to open NetEase and Ctrl+F to search. Playback uses yt-dlp with the same browser cookie source.
04features
10-Band Equalizer<br>Parametric EQ presets plus a persistent Custom curve that survives preset changes and restarts.
Themes & Visualizers<br>21 contrast-checked built-in themes and spectrum, waveform, particle, and true-stereo modes. Stereo provides dedicated L/R horizontal LED peak meters. Hot-swap with t / v.
Playlists<br>TOML...