Files
wehub-resource-sync ead81af521
CI / go (push) Waiting to run
CI / build (darwin, macos-14) (push) Waiting to run
CI / build (windows, windows-2025) (push) Waiting to run
Deploy to GitHub Pages / deploy (push) Failing after 0s
chore: import upstream snapshot with attribution
2026-07-13 12:31:13 +08:00

41 lines
1.8 KiB
Markdown

# Quickshell Now-Playing Widget (Omarchy)
A notification-sized "now playing" card for [Quickshell](https://quickshell.org), tailored for [Omarchy](https://omarchy.org). Lives in the repo at [`contrib/quickshell/`](../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:
```sh
qs -p contrib/quickshell/shell.qml
```
Or install it as a named Quickshell config:
```sh
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.