# bjarneo/cliamp

cliamp - Terminal music player inspired by winamp

Repository: https://github.com/bjarneo/cliamp
Canonical: https://ross.abutalabs.com/products/cliamp
Homepage: http://www.cliamp.stream
Language: Go
License: MIT
License Family: permissive
Topics: m3u, music, music-player, stream, winamp, yt-dlp, cliamp, icecast, icecast-player, navidrome-client, podcast, radio, navidrome, soundcloud, spotify, youtube, plugin-system, jellyfin-client, plex-client
Last push: 2026-08-26T19:28:12+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 85, longevity 13
- inputs: {"age_days": 190, "days_push": 7, "days_rel": 20, "gap_med": 0, "n_releases_24m": 154}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3745, forks 214 (observed 2026-08-28T04:08:15.849004+00:00)

## What it is
cliamp is a retro terminal music player inspired by Winamp, written in Go with a TUI built on Bubbletea. It plays local files, internet radio, podcasts, and streams from services like Spotify, YouTube, SoundCloud, Navidrome, Plex, and Jellyfin, with a spectrum visualizer, parametric EQ, and Lua plugin system.

## Use cases
- play music in the terminal
- listen to internet radio from the command line
- stream spotify or youtube music without a browser
- play podcasts and local audio files in a tui
- control plex, jellyfin, or navidrome playback from terminal
- add a winamp-style equalizer and visualizer to terminal audio
- extend a music player with lua plugins

## When to choose
- you want a full-featured music player that lives entirely in the terminal
- you aggregate audio from many sources (local files, radio, podcasts, streaming services, self-hosted servers)
- you miss Winamp's look and want EQ, visualizers, and playlists in a TUI
- you want a scriptable, plugin-extensible player

## When to avoid
- you need a graphical desktop music player with mouse-driven UI
- you only need background audio with no interactive interface
- you require codec or provider features not covered by its dependencies like ffmpeg or yt-dlp

## Facets
- artifact type: application
- maturity: active
- function: audio-processing, gui, plugin-system, cli
- domain: media, entertainment
- platform: windows, cli, cross-platform
- tags: terminal-ui, music-player, winamp, tui, streaming, podcasts, radio, yt-dlp, navidrome, jellyfin, plex, spotify, equalizer, visualizer, go, audio, command-line, linux, macos

## Member repositories
- bjarneo/cliamp (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:15.849004+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:29:03.766978+00:00, confidence not recorded.
  - readme: https://github.com/bjarneo/cliamp (fetched 2026-08-28T04:08:15.849004+00:00, sha 7dc00fa68c48)
  - homepage: http://www.cliamp.stream (fetched 2026-08-29T09:23:13.656897+00:00, sha c8f55637103b)
- Data as of 2026-08-30T08:39:29.467469+00:00.