LmCast :: Stay tuned in

A retro terminal music player inspired by Winamp

Recorded: March 24, 2026, 2:23 a.m.

Original Summarized

GitHub - bjarneo/cliamp: cliamp - Terminal music player inspired by winamp · GitHub

Skip to content

Navigation Menu

Toggle navigation

Sign in

Appearance settings

PlatformAI CODE CREATIONGitHub CopilotWrite better code with AIGitHub SparkBuild and deploy intelligent appsGitHub ModelsManage and compare promptsMCP RegistryNewIntegrate external toolsDEVELOPER WORKFLOWSActionsAutomate any workflowCodespacesInstant dev environmentsIssuesPlan and track workCode ReviewManage code changesAPPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilitiesCode securitySecure your code as you buildSecret protectionStop leaks before they startEXPLOREWhy GitHubDocumentationBlogChangelogMarketplaceView all featuresSolutionsBY COMPANY SIZEEnterprisesSmall and medium teamsStartupsNonprofitsBY USE CASEApp ModernizationDevSecOpsDevOpsCI/CDView all use casesBY INDUSTRYHealthcareFinancial servicesManufacturingGovernmentView all industriesView all solutionsResourcesEXPLORE BY TOPICAISoftware DevelopmentDevOpsSecurityView all topicsEXPLORE BY TYPECustomer storiesEvents & webinarsEbooks & reportsBusiness insightsGitHub SkillsSUPPORT & SERVICESDocumentationCustomer supportCommunity forumTrust centerPartnersView all resourcesOpen SourceCOMMUNITYGitHub SponsorsFund open source developersPROGRAMSSecurity LabMaintainer CommunityAcceleratorGitHub StarsArchive ProgramREPOSITORIESTopicsTrendingCollectionsEnterpriseENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platformAVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security featuresCopilot for BusinessEnterprise-grade AI featuresPremium SupportEnterprise-grade 24/7 supportPricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search

Clear

Search syntax tips

Provide feedback


We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.
You signed out in another tab or window. Reload to refresh your session.
You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

bjarneo

/

cliamp

Public

Notifications
You must be signed in to change notification settings

Fork
55

Star
1k

Code

Issues
20

Pull requests
5

Actions

Security
0

Insights

Additional navigation options

Code

Issues

Pull requests

Actions

Security

Insights


bjarneo/cliamp

 mainBranchesTagsGo to fileCodeOpen more actions menuFolders and filesNameNameLast commit messageLast commit dateLatest commit History257 Commits257 Commits.github/workflows.github/workflows  configconfig  docsdocs  externalexternal  internalinternal  lyricslyrics  mprismpris  playerplayer  playlistplaylist  resolveresolve  sitesite  telemetrytelemetry  themetheme  uiui  upgradeupgrade  .gitignore.gitignore  CNAMECNAME  LICENSELICENSE  README.mdREADME.md  config.toml.exampleconfig.toml.example  go.modgo.mod  go.sumgo.sum  install.shinstall.sh  logo.txtlogo.txt  main.gomain.go  mise.tomlmise.toml  View all filesRepository files navigationREADMEMIT license ██████ ██ ██ █████ ███ ███ ██████
██ ██ ██ ██ ██ ████ ████ ██ ██
██ ██ ██ ███████ ██ ████ ██ ██████
██ ██ ██ ██ ██ ██ ██ ██ ██
██████ ███████ ██ ██ ██ ██ ██ ██

A retro terminal music player inspired by Winamp. Play local files, streams, podcasts, YouTube, SoundCloud, Bilibili, Spotify, Xiaoyuzhou (小宇宙), 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.
Want to host your own radio? Check out cliamp-server.
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, Bandcamp and Bilibili
Lyrics
Spotify
Navidrome
Themes
Audio Quality
MPRIS
Telemetry

Omarchy
Add this keybind to launch cliamp with Super+Shift+M:
bindd = SUPER SHIFT, M, Music, exec, omarchy-launch-tui cliamp

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.

About

cliamp - Terminal music player inspired by winamp

www.cliamp.stream

Topics

radio

music

spotify

youtube

music-player

stream

podcast

soundcloud

icecast

winamp

m3u

icecast-player

navidrome

yt-dlp

navidrome-client

cliamp

Resources

Readme

License

MIT license

Uh oh!

There was an error while loading. Please reload this page.


Activity
Stars

1k
stars
Watchers

11
watching
Forks

55
forks

Report repository

Releases
68

v1.24.2

Latest

Mar 23, 2026


+ 67 releases

Packages
0

 

 

 

Uh oh!

There was an error while loading. Please reload this page.


Contributors
16

+ 2 contributors

Languages

Go
86.8%

HTML
13.0%

Shell
0.2%

Footer

© 2026 GitHub, Inc.

Footer navigation

Terms

Privacy

Security

Status

Community

Docs

Contact

Manage cookies

Do not share my personal information

You can’t perform that action at this time.

cliamp is a terminal music player designed to evoke the experience of Winamp, offering a nostalgic and functional audio playback solution. The project, spearheaded by bjarneo, utilizes a collection of Go libraries – Bubbletea, Lip Gloss, Beep, and go-librespot – to achieve this. It’s a software designed to provide a streamlined and accessible audio player directly within the terminal environment. The core functionality includes support for local files (MP3, FLAC), streaming services like YouTube, SoundCloud, Bilibili, Spotify, Xiaoyuzhou, and Navidrome, as well as radio stations. CLIamp incorporates features such as a spectrum visualizer, parametric EQ, and robust playlist management, allowing users to organize and control their music playback.

The installation process is straightforward, offering options through a shell script, Homebrew package manager, Arch Linux’s AUR repository, pre-built binaries, and building from source code. The project boasts a comprehensive set of documentation, broken down into categories including configuration, keybindings, CLI flags, streaming protocols, playlist management, support for various media platforms (YouTube, SoundCloud, Bandcamp, Bilibili, Spotify, Navidrome), lyrics integration, audio quality settings, support for technologies like MPRIS and Icecast, and telemetry for collection of usage data.

The project’s features can quickly be accessed through simple commands, for example, `cliamp ~/Music` to play a specified directory, `cliamp *.mp3 *.flac` to play matching files, or directly a URL, such as `cliamp https://example.com/stream`. Users can also use Ctrl+K to view all the available keybindings. The project actively maintains a radio channel which can be tuned in to through `cliamp https://radio.cliamp.stream/lofi/stream.pls`. For more customized radio station hosting there is also a cliamp-server available.

The project's documentation and development are driven by x.com/iamdothash who maintains the project and provides ongoing updates. An important disclaimer accompanies usage – prospective users are encouraged to use the software at their own risk. The project currently includes a glossary of topics for its functionality, detailing areas such as radio, music, Spotify, YouTube, stream, podcast, soundcloud, icecast and winamp. The project’s GitHub repository includes a list of contributors and a record of releases. The code is primarily written in Go, with some HTML configuration files.