cliamp

AU-03 // CLIAMP

cliamp is a retro terminal music player inspired by Winamp. It plays local files, internet radio, YouTube, SoundCloud, Spotify, and podcasts — all from the terminal with a spectrum visualizer and 10-band EQ.

cliamp music player with visualizer and EQ

Launch

Method	Command
Terminal	`cliamp`
Play file	`cliamp play ~/Music/song.mp3`
Play directory	`cliamp play ~/Music/`
Internet radio	`cliamp radio`
YouTube	`cliamp play <url>`

Features

Feature	Details
Formats	MP3, FLAC, OGG, WAV (AAC/Opus via ffmpeg)
Streaming	YouTube, SoundCloud, Bandcamp, Spotify, podcasts
Radio	30,000+ internet radio stations with built-in browser
Visualizer	Bars, Bricks, Columns, Wave, Scatter, Flame, Retro
EQ	10-band parametric equalizer with presets
Playlists	M3U/PLS support, queue management

Keybindings

Key	Action
`Space`	Play / pause
`n`	Next track
`p`	Previous track
`+` / `-`	Volume up / down
`v`	Cycle visualizer modes
`e`	Toggle EQ
`s`	Toggle shuffle
`r`	Toggle repeat
`Ctrl+K`	Show all keybindings

Configuration

Config lives at ~/.config/cliamp/config.toml:

volume = 80
visualizer = "bars"
theme = "default"
shuffle = false
repeat = "off"

Custom themes go in ~/.config/cliamp/themes/ and custom radio stations in ~/.config/cliamp/radios.toml.

Dependencies

cliamp uses PulseAudio for audio output (via PipeWire’s PulseAudio compatibility). Optional: ffmpeg for AAC/Opus playback, yt-dlp for YouTube/SoundCloud streaming.