Cliamp

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

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.

https://github.com/user-attachments/assets/fbc33d20-e3ac-4a62-a991-8a2f0243c8ea

Radio

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.

Install

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 .

Quick Start

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.

Docs

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

Omarchy

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

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

Author

x.com/iamdothash

Disclaimer

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