用途：cliamp 是运行在终端中的复古风格音乐播放器，用于播放本地音乐、网络流与播客，并整合多种流媒体与自建媒体服务器。
主要能力：支持 MP3、FLAC、WAV、OGG、AAC、ALAC、Opus、WMA 等本地格式，以及 HTTP、HLS、Icecast 流；可接入 Spotify、YouTube Music、SoundCloud、Bilibili、网易云音乐、Navidrome、Plex、Jellyfin。内置频谱可视化、参数均衡器、歌词视图、电台浏览器、播放列表管理与 Lua 插件系统，并支持 IPC 远程控制与 MPRIS。
安装：macOS/Linux 可执行 curl -fsSL https://raw.githubusercontent.com/bjarneo/cliamp/HEAD/install.sh | sh；macOS 也可用 brew install bjarneo/cliamp/cliamp；Arch 用 yay -S cliamp；源码构建需 Go 1.25.5+ 与 ALSA 开发头文件，执行 make && make install 或 go build -o cliamp .。扩展格式与流媒体建议安装 ffmpeg 与 yt-dlp。
使用方式：cliamp ~/Music 播放目录，cliamp *.mp3 播放指定文件，cliamp <URL> 播放流或平台链接；cliamp setup 配置远程服务并写入 ~/.config/cliamp/config.toml。播放中按 Ctrl+K 查看快捷键，空格/P 播放暂停，N 下一首，V 切换可视化，E 开关均衡器。支持 --playlist 加载 M3U/PLS，--headless 配合 cliamp ipc 远程控制。
适用场景：终端环境下的本地音乐播放、自建音乐服务器串流、脚本化播放与状态栏集成、SSH 远程串流。
限制：Spotify 流媒体需 Premium 账户；YouTube Music 等依赖 yt-dlp 与浏览器 Cookie；Linux 无声可能需安装 pipewire-alsa 或 pulseaudio-alsa；部分平台与配置细节以官方文档为准，资料未提供的内容暂未说明。