A retro terminal music player inspired by Winamp
Cliamp is a retro terminal music player inspired by Winamp, supporting local files, streaming services like Spotify and YouTube, and featuring a built-in spectrum visualizer.
██████ ██ ██ █████ ███ ███ ██████
██ ██ ██ ██ ██ ████ ████ ██ ██
██ ██ ██ ███████ ██ ████ ██ ██████
██ ██ ██ ██ ██ ██ ██ ██ ██
██████ ███████ ██ ██ ██ ██ ██ ██
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.
Source: Hacker News
