CLIAMP
terminal music player
A retro music player inspired by Winamp — built for the terminal.
Spectrum visualizer, 10-band EQ, playlists, streaming, and more.
Listen to our radio channel:
cliamp http://cliamp.stream/public/iamdothash/playlist.pls
Install GitHub →
Demo
Install
$ curl -fsSL https://raw.githubusercontent.com/bjarneo/cliamp/HEAD/install.sh | sh Copied!
Homebrew (macOS / Linux)
$ brew install bjarneo/cliamp/cliamp Copied!
Arch Linux (AUR)
$ yay -S cliamp Copied!
Or build from source: see the README
Features
♫
Audio Formats

MP3, WAV, FLAC, OGG, AAC, ALAC, Opus, and WMA

☰
10-Band Equalizer

Parametric EQ with presets: Rock, Jazz, Pop, Classical, and more

◈
Themes & Visualizers

Multiple color themes and visualizer modes to match your vibe

☰
Playlists

TOML playlists, M3U/M3U8/PLS support, built-in playlist manager

→
HTTP Streaming

Play from URLs, internet radio stations, and remote M3U playlists

▶
yt-dlp Integration

YouTube, SoundCloud, and Bandcamp playback via yt-dlp

◘
Podcasts

Pass an RSS feed URL and listen to any podcast in your terminal

☁
Navidrome

Browse and stream your self-hosted Navidrome music library

⇄
Gapless Playback

Seamless track transitions with preloaded next-track buffering

♬
MPRIS / Media Keys

Linux desktop integration — control playback with hardware media keys and playerctl

⚙
Audio Quality

Configurable sample rate (22kHz–192kHz), buffer size, and resample quality

⌨
Live Radio Metadata

ICY/Shoutcast metadata — see the current song title on internet radio streams

✎
Embedded Tag Reading

ID3v2, Vorbis comments, and MP4 atoms — reads artist, album, genre, year, and track number from your files

▶
CLI Flags

Override volume, shuffle, repeat, mono, theme, EQ, sample rate, and more per-session from the command line

↑
Self-Update

Run --upgrade to update to the latest release directly from your terminal

Themes

17 built-in themes. Press t to switch, or use --theme "name" from the CLI. Drop a .toml file in ~/.config/cliamp/themes/ to add your own.

Ayu Mirage Dark
Catppuccin
Catppuccin Latte
Ethereal
Everforest
Flexoki Light
Gruvbox
Hackerman
Kanagawa
Matte Black
Miasma
Nord
Osaka Jade
Ristretto
Rosé Pine
Tokyo Night
Vantablack
Each bar represents: accent, bright foreground, foreground, green, yellow, red
CLI Flags

Override any config option for a single session. Flags can appear before, after, or between file arguments.

--volume <dB>Volume [-30, +6]
--shuffleEnable shuffle
--repeat <mode>off, all, or one
--mono / --no-monoMono downmix
--auto-playStart playback immediately
--theme <name>UI theme
--eq-preset <name>EQ preset
--sample-rate <Hz>Output sample rate
--buffer-ms <ms>Speaker buffer (50–500)
--resample-quality <n>Resample quality (1–4)
--upgradeUpdate to latest release
--help / --versionHelp & version info
Keybindings
SpacePlay / Pause
sStop
> .Next track
< ,Previous track
← →Seek −/+5s
+ / −Volume up / down
mToggle mono
TabFocus: Playlist / EQ
j kScroll / adjust EQ
h lEQ band left / right
EnterPlay selected
eCycle EQ preset
tChoose theme
vCycle visualizer
VFull-screen visualizer
/Search playlist
xExpand playlist
oOpen file browser
aQueue (play next)
AQueue manager
pPlaylist manager
iTrack info / metadata
rRepeat: Off / All / One
zToggle shuffle
SSave to ~/Music
Esc / bBack to provider
Ctrl+KShow keymap
qQuit