← 返回命令列表

Linux command

cliamp 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Play all audio files

cliamp ~/Music

Play specific files

cliamp *.mp3 *.flac *.wav *.ogg

Play with shuffle

cliamp --shuffle --volume -5 [path/to/music]

Stream audio

cliamp [https://example.com/song.mp3]

Play an M3U playlist

cliamp [path/to/playlist.m3u]

Play a podcast

cliamp [https://example.com/podcast/feed.xml]

说明

cliamp is a retro terminal music player inspired by Winamp 2.x. It plays MP3, WAV, FLAC, OGG, AAC, ALAC, Opus, and WMA with a 10-band spectrum visualizer, 10-band parametric EQ, and playlist management. It supports local files, directories (recursive scanning), HTTP streaming, M3U/M3U8 playlists, podcast RSS feeds, and URLs from YouTube, SoundCloud, Bandcamp, Bilibili, and Spotify (via yt-dlp). A built-in file browser and playlist manager allow organizing music from within the terminal. cliamp can also connect to a Navidrome server for remote music streaming via environment variables.

参数

--volume _dB_
Volume in dB, range -30 to +6. Default 0.
--shuffle
Enable shuffle mode.
--repeat _mode_
Set repeat mode: off, all, or one. Default off.
--mono / --no-mono
Enable or disable mono output (L+R downmix).
--auto-play
Start playback immediately.
--theme _name_
Set UI theme by name.
--eq-preset _name_
Set EQ preset: Flat, Rock, Pop, Jazz, Classical, Bass Boost, Treble Boost, Vocal, Electronic, Acoustic.
--bit-depth _n_
PCM bit depth: 16 (default) or 32 (lossless).
--sample-rate _Hz_
Output sample rate: 22050, 44100, 48000, 96000, 192000. Default 44100.
--buffer-ms _ms_
Speaker buffer in milliseconds, range 50-500. Default 100.
--resample-quality _n_
Resample quality factor, range 1-4. Default 4.
--visualizer _mode_
Visualizer mode: Bars, Bricks, Columns, Wave, Scatter, Flame, Retro, None.
-h, --help
Show help and exit.
-v, --version
Print version and exit.
--upgrade
Update to the latest release.

FAQ

What is the cliamp command used for?

cliamp is a retro terminal music player inspired by Winamp 2.x. It plays MP3, WAV, FLAC, OGG, AAC, ALAC, Opus, and WMA with a 10-band spectrum visualizer, 10-band parametric EQ, and playlist management. It supports local files, directories (recursive scanning), HTTP streaming, M3U/M3U8 playlists, podcast RSS feeds, and URLs from YouTube, SoundCloud, Bandcamp, Bilibili, and Spotify (via yt-dlp). A built-in file browser and playlist manager allow organizing music from within the terminal. cliamp can also connect to a Navidrome server for remote music streaming via environment variables.

How do I run a basic cliamp example?

Run `cliamp ~/Music` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does --volume _dB_ do in cliamp?

Volume in dB, range -30 to +6. Default 0.