cliamp

Project Overview

cliamp is a retro terminal music player inspired by Winamp, supporting local files, streams, podcasts, and content from YouTube, YouTube Music, SoundCloud, Mixcloud, Bilibili, Spotify, NetEase Cloud Music, Xiaoyuzhou, Navidrome, Lyrion, Plex, Jellyfin, and Audiobookshelf. It features a built-in spectrum visualizer, parametric EQ, and playlist manager.

Key Features

• Supports multiple sources: local files, streams, podcasts, YouTube, Spotify, NetEase Cloud Music, and more
• Built-in spectrum visualizer
• Parametric equalizer
• Playlist manager
• Built with Bubbletea, Lip Gloss, Beep, and go-librespot

Target Audience

• Music enthusiasts who love the retro Winamp style
• Users who prefer operating music players in the terminal
• Users who need cross-platform music playback

Quick Start

1. Quick install: curl -fsSL https://raw.githubusercontent.com/bjarneo/cliamp/HEAD/install.sh | sh
2. Homebrew: brew install bjarneo/cliamp/cliamp
3. Arch Linux (AUR): yay -S cliamp
4. Nix: nix run github:bjarneo/cliamp
5. Go: go install github.com/bjarneo/cliamp@latest

Core Advantages

• Retro Winamp style for a nostalgic experience
• Supports multiple major music platforms and formats
• Built-in visualization and equalizer
• Cross-platform support (macOS, Linux, Windows)

System Requirements

• OS: macOS, Linux, Windows
• Optional Dependencies: ffmpeg (for AAC, ALAC, Opus, WMA playback), yt-dlp (for YouTube and other platforms)