GStars
    bjarneo

    bjarneo/cliamp

    cliamp - Terminal music player inspired by winamp

    cli
    cliamp
    icecast
    icecast-player
    jellyfin-client
    m3u
    Go
    MIT
    4.5K stars
    325 forks
    4.5K GitHub watchers
    Updated Oct 26, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    5 releases in the last 90 days, the latest 28 days ago, with 120 contributors on GitHub.

    Use Cases & Benefits

    • A terminal-based music player inspired by Winamp that supports local files, streams, podcasts, and multiple online music services with visualizer and EQ features.
    • Offers extensive multi-source playback including YouTube, Spotify, SoundCloud, and media servers with a lightweight, keyboard-driven terminal interface.
    • Use for playing and managing diverse audio sources directly from the terminal with playlist and parametric equalizer controls.
    • Use for integrating music playback from media servers like Plex, Jellyfin, and Navidrome in a unified CLI environment.
    • Use for browsing and streaming thousands of online radio stations with customizable station lists and remote provider setup.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    MIT

    Permissive: commercial use, modification and redistribution are allowed with attribution.

    Community files

    • README: present

    Watch-outs

    No watch-outs from GStars' checks.

    General guidance from repository metadata, not legal advice. How we score

    From the README

    A retro terminal music player inspired by Winamp. Play local files, streams, podcasts, YouTube, YouTube Music, SoundCloud, Bilibili, Spotify, NetEase Cloud Music, Xiaoyuzhou (小宇宙), Navidrome, Plex, and Jellyfin with a spectrum visualizer, parametric EQ, and playlist management.

    Built with Bubbletea, Lip Gloss, Beep, and go-librespot.

    The formula pulls in all required runtime libraries automatically.

    Linux builds need ALSA development headers installed first. See Building from source.

    macOS: the pre-built binaries dynamically link against FLAC, Vorbis, and Ogg from Homebrew. If you download directly from Releases (or use the install.sh script) you must install them first, otherwise you will see errors like Library not loaded: /opt/homebrew/opt/libvorbis/lib/libvorbisenc.2.dylib:

    brew install flac libvorbis libogg

    Installing via brew install bjarneo/cliamp/cliamp does this for you.

    Linux: the pre-built binaries statically link FLAC, Vorbis, and Ogg, so no extra codec packages are required. You may still need an ALSA bridge for your sound server — see Troubleshooting.

    Windows: download cliamp-windows-amd64.exe from Releases. If HOME is not set, cliamp stores its config under %APPDATA%\cliamp. The Spotify provider is currently unavailable on Windows builds.

    Excerpt from the bjarneo/cliamp README on GitHub (MIT license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Aug 18: +76Aug 19: +39Aug 20: +19Aug 27: +35Aug 28: +49Aug 29: +23Aug 30: +28Aug 31: +13Sep 14: +27Sep 15: +6Sep 18: +13Sep 19: +13Sep 20: +7Sep 21: +15Sep 22: +24Sep 23: +23Sep 24: +19Sep 25: +12Sep 26: +6

    +1,393 stars over 71 days across 25 snapshot days; best day +76 on Aug 18.

    Forks

    325+155

    Open issues

    144+94

    Compared with peers in CLI

    Fastest-growing repositories GStars tracks in this cohort for the week of Nov 1, by 7-day star growth

    View category →
    bjarneo/cliamp compared with CLI repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    vercel-labs/agent-desktop17.0K+13.3K33today
    mattpocock/skills315.4K+8.7K357 days ago
    stablyai/orca116.8K+6.6K40today
    obra/superpowers313.1K+4.5K532 days ago
    Panniantong/Agent-Reach109.3K+3.0K604 days ago
    bjarneo/cliamp4.5K—5328 days ago
    Category median116.8K+6.6K40—
    Compare cliamp with agent-desktop, skills, orca →

    Discover Repositories

    Search across tracked repositories by name or description