bjarneo--cliamp/docs/quickshell.md at main

Files

T

Bjarne Øverli 84ef9f1a30 contrib/quickshell: enlarge card to 300x72 and align visualizer width

Bumps the card slightly (260x62 -> 300x72) with proportional font and
button-size increases so the layout breathes a bit more without losing
its dense Winamp feel. Visualizer height grows to 22px for more LED
rows; transport buttons grow to 16/20px so the play icon stays
emphasized.

Also fixes a long-standing alignment quirk in Visualizer: the bar block
was integer-sized and centered, leaving a small gutter on each side
that didn't match the edge-to-edge seek line. Now bar widths stay
integer (crisp pixels) and the leftover space is absorbed into the
inter-bar gaps, so the bars span exactly the parent width and align
with the seek line below.

2026-05-15 15:09:35 +02:00

1.8 KiB

Raw Permalink Blame History

A notification-sized "now playing" card for Quickshell, tailored for Omarchy. Lives in the repo at contrib/quickshell/.

It pulls live spectrum data from a running cliamp over the IPC socket, draws a Winamp 2-style segmented analyzer, and reads colors directly from the active Omarchy theme so it restyles in lock-step when you swap themes.

This widget is built for an Omarchy setup. It uses Omarchy's ~/.config/omarchy/current/theme/colors.toml as the source of truth for its palette. On a non-Omarchy system the panel still works but falls back to the default kanagawa-dragon-ish colors baked into NowPlaying.qml.

What you get

300 x 72 card centered along the bottom of every screen
Full-width Winamp 2-style LED spectrum analyzer with falling peak caps
Track title + artist, click-to-seek progress bar, time readout
Pristine vector transport icons (prev / play-pause / next), no font dependency
Theme follows the active Omarchy theme (background, foreground, accent, color1..color8, selection_background)
Card border tracks the muted slot of the Omarchy palette (selection_background, falling back to color8)
Click the card and press Esc or Q to dismiss

Quick start

Make sure cliamp is running first, then either run the widget directly:

qs -p contrib/quickshell/shell.qml

Or install it as a named Quickshell config:

mkdir -p ~/.config/quickshell
ln -s "$PWD/contrib/quickshell" ~/.config/quickshell/cliamp
qs -c cliamp

Requirements

Quickshell 0.2+
A running cliamp (Linux only; the widget needs cliamp's MPRIS service and IPC socket)
Omarchy, for the theme integration. Without Omarchy the palette stays on the built-in defaults.

1.8 KiB Raw Permalink Blame History

Quickshell Now-Playing Widget (Omarchy)

What you get

Quick start

Requirements

1.8 KiB

Raw Permalink Blame History