CLIAMP — Terminal Music Player

Install

Direct

$ curl -fsSL https://raw.githubusercontent.com/bjarneo/cliamp/HEAD/install.sh | sh Copied!

Homebrew (macOS / Linux)

$ brew install bjarneo/cliamp/cliamp Copied!

Arch Linux (AUR)

$ yay -S cliamp Copied!

Or build from source: see the README

Features

♫

Audio Formats

MP3, WAV, FLAC, OGG, AAC, ALAC, Opus, and WMA

☰

10-Band Equalizer

Parametric EQ with presets: Rock, Jazz, Pop, Classical, and more

◈

Themes & Visualizers

Multiple color themes and visualizer modes to match your vibe

☰

Playlists

TOML playlists, M3U/M3U8/PLS support, built-in playlist manager

→

HTTP Streaming

Play from URLs, internet radio stations, and remote M3U playlists

▶

yt-dlp Integration

YouTube, SoundCloud, and Bandcamp playback via yt-dlp. Search YouTube with cliamp search "query" or SoundCloud with cliamp search-sc "query". Press f / F to search in-player

◘

Podcasts

Pass an RSS feed URL and listen to any podcast in your terminal

☁

Navidrome

Browse and stream your self-hosted Navidrome music library

♪

Lyrics

Synced lyrics with auto-scroll for local & Navidrome tracks, manual scroll for streams. Press y to view

⇄

Gapless Playback

Seamless track transitions with preloaded next-track buffering

♬

MPRIS / Media Keys

Linux desktop integration — control playback with hardware media keys and playerctl

⚙

Audio Quality

Configurable sample rate (22kHz–192kHz), buffer size, and resample quality

⌨

Live Radio Metadata

ICY/Shoutcast metadata — see the current song title on internet radio streams

✎

Embedded Tag Reading

ID3v2, Vorbis comments, and MP4 atoms — reads artist, album, genre, year, and track number

▶

CLI Flags

Override volume, shuffle, repeat, mono, theme, EQ, sample rate, and more per-session

↑

Self-Update

Run --upgrade to update to the latest release directly from your terminal

Themes

17 built-in themes. Press t to switch, or use --theme "name" from the CLI. Drop a .toml file in ~/.config/cliamp/themes/ to add your own.

Ayu Mirage Dark

Catppuccin

Catppuccin Latte

Ethereal

Everforest

Flexoki Light

Gruvbox

Hackerman

Kanagawa

Matte Black

Miasma

Nord

Osaka Jade

Ristretto

Rosé Pine

Tokyo Night

Vantablack

Each bar represents: accent, bright foreground, foreground, green, yellow, red

CLI Flags

Override any config option for a single session. Flags can appear before, after, or between file arguments.

--volume <dB>Volume [-30, +6]

--shuffleEnable shuffle

--repeat <mode>off, all, or one

--mono / --no-monoMono downmix

--auto-playStart playback immediately

--theme <name>UI theme

--eq-preset <name>EQ preset

--sample-rate <Hz>Output sample rate

--buffer-ms <ms>Speaker buffer (50–500)

--resample-quality <n>Resample quality (1–4)

--upgradeUpdate to latest release

--help / --versionHelp & version info

Keybindings

SpacePlay / Pause

sStop

> .Next track

< ,Previous track

← →Seek −/+5s

Shift+← Shift+→Seek −/+large step (default 30s)

+ / −Volume up / down

mToggle mono

TabFocus: Playlist / EQ

j kScroll / adjust EQ

h lEQ band left / right

EnterPlay selected

eCycle EQ preset

tChoose theme

vCycle visualizer

VFull-screen visualizer

/Search playlist

fFind on YouTube (queue)

FFind on SoundCloud (queue)

uLoad URL (stream/playlist)

yShow lyrics

JJump to time

xExpand playlist

oOpen file browser

aQueue (play next)

AQueue manager

pPlaylist manager

iTrack info / metadata

rRepeat: Off / All / One

zToggle shuffle

SSave to ~/Music

Esc / bBack to provider

Ctrl+KShow keymap

qQuit