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)

yay -S cliamp

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.

• Configuration
• Keybindings
• CLI Flags
• Streaming
• Playlists
• YouTube, SoundCloud, Bandcamp and Bilibili
• Lyrics
• Spotify
• Navidrome
• Themes
• Audio Quality
• MPRIS
• Telemetry

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

:

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

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