How bjarneo/cliamp works
cliamp is a retro terminal music player for local media, streams, podcasts, radio, and many remote music services. The principal workflow begins with CLI startup and track or URL resolution, then presents and controls a queue in the terminal UI while the player decodes and outputs audio. Provider integrations supply browsable/searchable media, and the product also offers remote control, Lua plugins, and OS media-key integration. Main startup imports establish several runtime links; broader provider and radio workflows are documented in the README, so unsampled internals are represented at subsystem level.
Main entry points: interfaces.go Provider Contracts · main.go CLI Startup · setup.go Provider Setup · model Terminal UI
Components 22
Application Runtime
- CLI Startup
main.go - Terminal UI
ui/model
Media Playback
- Input Resolver
resolve/resolve.go - Playlist Model
playlist/playlist.go - Audio Player
player/player.go
Media Sources
- Local Library
external/local/provider.go - Radio Directory
external/radio/provider.go - Podcast Provider
external/podcast/provider.go - Provider Contracts
provider/interfaces.go
Remote Services
- Lyrion Client
external/lyrion/client.go - Navidrome Client
external/navidrome/client.go - Plex Client
external/plex/client.go - Emby/Jellyfin API
internal/embyapi/client.go - Spotify Session
external/spotify/session.go - Qobuz Client
external/qobuz/client.go - Tidal Client
external/tidal/client.go - Yandex Client
external/yandex/client.go - Provider Setup
cmd/setup.go
Control Extensions
- IPC Server
ipc/server.go - Lua Plugins
luaplugin/luaplugin.go - OS Media Controls
mediactl/service_darwin.go
Other components
- Listener
Connections 32
- Listener → CLI Startup: starts player
- CLI Startup → Input Resolver: resolves inputs
main.go - CLI Startup → Audio Player: creates player
main.go - CLI Startup → Terminal UI: configures UI
main.go - CLI Startup → IPC Server: starts control
main.go - CLI Startup → Lua Plugins: loads plugins
main.go - CLI Startup → Radio Directory: uses radio
main.go - Input Resolver → Playlist Model: builds tracks
resolve/resolve.go - Terminal UI → Playlist Model: searches providers
ui/model/keys_search.go - Audio Player → Listener: plays audio
- Listener → Provider Setup: configures services
- Provider Setup → Lyrion Client: validates connection
cmd/setup.go - Provider Setup → Navidrome Client: validates connection
cmd/setup.go - Provider Setup → Plex Client: validates connection
cmd/setup.go - Provider Setup → Emby/Jellyfin API: validates connection
cmd/setup.go - Provider Contracts → Playlist Model: defines interface
provider/interfaces.go - Lyrion Client → Provider Contracts: implements provider
external/lyrion/client.go - Navidrome Client → Provider Contracts: implements provider
external/navidrome/client.go - Plex Client → Provider Contracts: implements provider
external/plex/client.go - Emby/Jellyfin API → Provider Contracts: implements provider
internal/embyapi/client.go - Local Library → Provider Contracts: implements provider
external/local/provider.go - Listener → Radio Directory: browses stations
- Listener → Podcast Provider: discovers shows
- Listener → IPC Server: sends commands
- IPC Server → Terminal UI: dispatches requests
- Lua Plugins → Audio Player: controls playback
- OS Media Controls → Terminal UI: sends controls
mediactl/service_darwin.go - Listener → OS Media Controls: uses media keys
- Spotify Session → Provider Contracts: supplies service media
- Qobuz Client → Provider Contracts: supplies service media
- Tidal Client → Provider Contracts: supplies service media
- Yandex Client → Provider Contracts: supplies service media