Player, visualizer and a Spotify playlist stacked in one narrow window, the way Winamp sat on a 2000s desktop.
cliamp ships with Omarchy, so all you need is the deck. One line installs it to ~/.local/bin and adds it to the
app launcher (Super + Space) with cliamp's icon. No sudo, nothing to compile:
curl -fsSL https://raw.githubusercontent.com/demian0311/cliamp-deck/master/install.sh | bashRun the same line again to update. To remove it and its launcher entry:
curl -fsSL https://raw.githubusercontent.com/demian0311/cliamp-deck/master/install.sh | bash -s -- --uninstallThe script downloads the release binary for your CPU and checks it against the release's SHA256SUMS; read
install.sh first if you prefer.
Or as a pacman package (x86_64), so omarchy update keeps it current. One line adds the signed
[cliamp-deck] repository and installs it:
curl -LO https://github.com/demian0311/cliamp-deck/releases/download/arch-repo/cliamp-deck-keyring.pkg.tar.zst &&
sudo pacman -U ./cliamp-deck-keyring.pkg.tar.zst && sudo pacman -Sy cliamp-deckElsewhere, or from source — needs Go; on Omarchy mise use -g go@latest provides it:
GOBIN=~/.local/bin go install github.com/demian0311/cliamp-deck@latestAny Linux with cliamp v2.0.1 or newer and a truecolor terminal works. On start the deck asks the running cliamp which remote operations it supports, and exits with an update hint if any it uses are missing.
cliamp-deck # starts `cliamp --daemon` if nothing is running
cliamp-deck --spawn=false --socket PATH # attach to a specific instance only
cliamp-deck --icons plain # plain player icons, for a terminal font without Nerd Font glyphsAlternative terminal UI for cliamp: a btop-style grid and a Winamp-style player that re-flow with the terminal, plus a stage of audio-reactive demoscene effects painted in your Omarchy theme's colours. All audio, providers and the spectrum come from a running cliamp over its V2 IPC socket.
Over fifteen visualizers, all reacting to the music and all painted from your theme — plasma, fire, metaballs, ridges, spectrum, timescope, vortex, water, synaesthesia, scope, fountain, aurora, skyline, coral, flow, life, moire and braille:
Browse cliamp's sources — internet radio by country, plus whatever else you have set up — with the player, levels and a visualizer alongside:
![]() |
![]() |
| Light themes work too: the EQ open, vortex drawn as ink on paper. | A small terminal stacks the panels; spectrum stays as short as the player. |
Screenshots in Omarchy's Slate Dark and Slate Light themes, playing a cliamp radio stream (the opening animation, a Spotify playlist).
Layout: player on top, visualizer in the middle, sources at the bottom (side by side on very wide terminals). Click the visualizer, or press Enter on it, to let it take over the terminal; click or Esc to come back.
Quitting the deck stops the music: a headless cliamp --daemon exits with it, a cliamp TUI just stops playing
(--keep-playing leaves it running).
Keys: space play/pause · n/p skip · , . seek · +/- volume · Tab focus player → visualizer → sources (the focused panel's title sits on an accent tint) ·
in the player: ↑/↓ volume, ←/→ seek · e shows or hides the EQ from anywhere (←/→ band, ↑/↓ gain, p preset, 0 off) ·
v or ‹ › cycle visualizers (←/→ when it has focus) · V take over · { } move the picture 10 ms earlier/later
against the sound (Bluetooth adds its own delay) ·
in sources: ↑/↓ move, → open a source, country or playlist, ← back (Radio lists countries; open one for its stations), Enter play (a playlist also opens), a add to queue, A play next, [ ] tabs (sources/history), / search,
s set up a source with cliamp setup · q quit. Mouse: click and double-click rows, scroll the list, click tabs.
The deck remembers your EQ, visualizer, sync delay and last station or track in ~/.config/cliamp-deck/state.toml (cliamp's
daemon does not save EQ). When it attaches it reapplies the EQ and, if nothing is playing, starts that station again.
Stage effects live in fx/ (interface: pixel frame + bass/mid/treble/beat + theme). Each cell is a ▀
with 24-bit fg/bg, so the terminal must support truecolor. Colours come from the Omarchy theme at
~/.local/state/omarchy/current/theme/colors.toml (override: --theme PATH), re-read within 2 s of
omarchy theme set.
Known limits (2026-09-26):
spectrum.getserves 10 bands and no waveform; every visualizer and the level meter work from those bands (scope draws its figures from them, not from the real signal).- A cliamp TUI instance only refreshes its bands while its own visualizer renders, so attached to one
the visualizers can freeze. Run cliamp as
--daemonfor live bands. - Providers only appear once configured in cliamp's config (e.g. Spotify needs a
[spotify]section). - Titles with wide (CJK/emoji) glyphs will misalign the grid.
Screenshots are real captures: a second cliamp --daemon (own CLIAMP_CONFIG_DIR, --audio-device a PipeWire
null sink, so nothing is heard) plays a radio stream, the deck runs in a private tmux server
(tmux -L shots, terminal-features '*:RGB') with TMUX unset, TERM=xterm-256color and COLORTERM=truecolor — otherwise it
detects tmux and falls back to 256 colours — and tmux capture-pane -e dumps each frame. docs/screenshots/ansi2png.py
renders it with a theme's terminal palette (THEME_DIR=<omarchy theme dir>, default the applied theme).







