About this project

cliamp is a terminal-based music player with a retro interface inspired by Winamp. It is written in Go and uses Bubbletea and Lip Gloss for its TUI, Beep for audio playback, and go-librespot for Spotify support. What it plays - Local files and directories, plus direct stream URLs. - Podcasts: browse Apple's top 100 shows across 19 categories, search, and subscribe without an account or API key. - Online radio: browse roughly 58,000 stations from the Radio Browser directory, filter by country or genre/tag, and pin favorite countries. Location is only used if you explicitly opt in, and is derived from the system timezone rather than a geo-IP service. - Remote providers configured through an interactive setup wizard: Navidrome, Lyrion, Plex, Jellyfin, Audiobookshelf, Spotify, Mixcloud, YouTube Music, and NetEase Cloud Music. - Additional sources via yt-dlp: YouTube, SoundCloud, Mixcloud, Bandcamp, Bilibili, and NetEase Cloud Music. Features - Spectrum visualizer, parametric equalizer, and playlist manager. - Custom radio stations can be added through a radios.toml config file. - Keybindings are listed in-app via Ctrl+K. Installation - Shell installer script, Homebrew tap, Arch AUR package, Nix flake, and go install are documented. - Pre-built binaries are available from GitHub Releases. - Optional runtime dependencies: ffmpeg for AAC, ALAC, Opus and WMA playback, and yt-dlp for several streaming providers. Platform notes - Linux builds need ALSA development headers; PipeWire or PulseAudio users may need a bridge package such as pipewire-alsa or pulseaudio-alsa for audio output. - macOS pre-built binaries link dynamically to FLAC, Vorbis, Ogg and mpg123 libraries from Homebrew. - Windows builds use pure-Go decoding for the core player; Spotify support requires CGO and a MinGW toolchain. A companion native Android client, cliamp mobile, targets radio, podcasts, and the same server integrations. A separate cliamp-server project is offered for hosting a radio station. Documentation is hosted externally, and the project is sponsored by contextowl.co.