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

A retro terminal music player inspired by Winamp. Play local files, streams, podcasts, YouTube, SoundCloud, Spotify, 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

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.

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 and Bandcamp
• Lyrics
• Spotify
• Navidrome
• Themes
• Audio Quality
• MPRIS
• Telemetry

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.