Back Original

A retro terminal music player inspired by Winamp

 ██████ ██      ██  █████  ███    ███ ██████
██      ██      ██ ██   ██ ████  ████ ██   ██
██      ██      ██ ███████ ██ ████ ██ ██████
██      ██      ██ ██   ██ ██  ██  ██ ██
 ██████ ███████ ██ ██   ██ ██      ██ ██

A retro terminal music player inspired by Winamp. Play local files, streams, podcasts, YouTube, SoundCloud, Bilibili, Spotify, Xiaoyuzhou (小宇宙), and Navidrome with a spectrum visualizer, parametric EQ, and playlist management.

Built with Bubbletea, Lip Gloss, Beep, and go-librespot.

cliamp_whips_tty_ass_compressed.mp4

Tune in to our radio channel:

cliamp https://radio.cliamp.stream/lofi/stream.pls

Add your own stations to ~/.config/cliamp/radios.toml. See docs/configuration.md.

Want to host your own radio? Check out cliamp-server.

curl -fsSL https://raw.githubusercontent.com/bjarneo/cliamp/HEAD/install.sh | sh

Homebrew

brew install bjarneo/cliamp/cliamp

Arch Linux (AUR)

Pre-built binaries

Download from GitHub Releases.

Build from source

git clone https://github.com/bjarneo/cliamp.git && cd cliamp && go build -o cliamp .
cliamp ~/Music                     # play a directory
cliamp *.mp3 *.flac               # play files
cliamp https://example.com/stream  # play a URL

Press Ctrl+K to see all keybindings.

Prerequisites:

  • Go 1.25.5 or later
  • ALSA development headers (Linux only — required by the audio backend)

Linux (Debian/Ubuntu):

sudo apt install libasound2-dev

Linux (Fedora):

sudo dnf install alsa-lib-devel

Linux (Arch):

macOS: No extra dependencies — CoreAudio is used.

Clone and build:

git clone https://github.com/bjarneo/cliamp.git
cd cliamp
go build -o cliamp .

Optional runtime dependencies:

  • ffmpeg — for AAC, ALAC, Opus, and WMA playback
  • yt-dlp — for YouTube, SoundCloud, Bandcamp, and Bilibili

Add this keybind to launch cliamp with Super+Shift+M:

bindd = SUPER SHIFT, M, Music, exec, omarchy-launch-tui cliamp

x.com/iamdothash

Use this software at your own risk. We are not responsible for any damages or issues that may arise from using this software.