From 45bcde0b9ca2bef832139f703dd46e98fe8eceb4 Mon Sep 17 00:00:00 2001 From: elwrcl Date: Sat, 3 Oct 2026 21:24:38 +0300 Subject: [PATCH] docs: picker and backdrop in the README and checklist --- README.md | 23 ++++++++++++++++++++++- docs/test-checklist.md | 10 ++++++++++ 2 files changed, 32 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index c4c6b0b..778c7ba 100644 --- a/README.md +++ b/README.md @@ -59,15 +59,36 @@ binds { |---|---| | `valw screen [--all]` | The focused output (or every output) | | `valw region` | Drag a region; Shift locks an axis, Alt grows from the centre, Space moves it; Space before dragging switches to window mode | -| `valw window` | Click a window | +| `valw window [--pick]` | Pick a window from cards over a liquid-paint background (Tab/arrows, Enter, Esc); `--pick` clicks it on screen instead | | `valw zoom` | Freeze the screen and zoom: wheel, drag, `f` flashlight, `c` capture the view, `0` reset, Esc | | `valw toolbar` | Pick a mode from a floating bar, with a timer and options | | `valw edit FILE` | The markup editor (clicking a preview opens it) | +| `valw backdrop` | Keep running: the liquid-paint background behind niri's overview (below) | | `valw doctor` | What the compositor and system support | Capture commands take `--clipboard-only`, `-o PATH` (`-` for stdout), `--delay SECS`, `--cursor` and `--no-preview`. +## The overview backdrop + +`valw backdrop` draws a slow liquid-paint background, coloured from the +wallpaper (via Noctalia, if it runs), behind niri's overview. It only draws +while the overview shows it. Start it with niri and place it in the +backdrop: + +```kdl +spawn-at-startup "valw" "backdrop" + +layer-rule { + match namespace="^valw-backdrop$" + place-within-backdrop true +} +``` + +With Noctalia, turn its own backdrop off (`[backdrop] enabled = false`). +Colours elsewhere (the region dim, the window picker's fallback) follow +Noctalia's current community palette when there is one. + ## Configuration Every key is optional; these are the defaults. diff --git a/docs/test-checklist.md b/docs/test-checklist.md index 08c1b5b..a4c4ecc 100644 --- a/docs/test-checklist.md +++ b/docs/test-checklist.md @@ -168,3 +168,13 @@ image, a cancel brought the thumbnail back, and a swipe still dismissed it. - The README's module example assumes `inputs` is passed to home-manager modules. - The source filter drops any `docs` or `README.md` at any depth, not just the root ones. - The README's niri binds clash with niri's default `Print` bind if pasted next to it. + +## Theme + +- [ ] Region (Mod+Shift+S): the dim outside the selection takes the Noctalia theme's colour (light and dark mode), still see-through; it opens as fast as before. +- [ ] `valw window` (Mod+Shift+W): cards for every window, most recently used first, icons right (Ghostty, Dolphin, Telegram, Spotify…), long titles ellipsised; Tab/Shift+Tab/arrows/hover move the selection; Enter or a click captures that window (shadow, sound, preview); Esc or a click outside cancels. +- [ ] The picker's shader alternates swirl/flow per run and takes the selected window's colours, easing between cards; the picker never appears in the shot. +- [ ] 20+ windows still fit (cards shrink); a window without an icon shows its initial. +- [ ] Toolbar → Window opens the picker; Space in region mode still uses niri's click-a-window. +- [ ] Overview (Mod+Tab): the paint flows slowly behind the workspaces, coloured from the current wallpaper; after the wallpaper changes, the next overview eases to the new colours; no GPU load while the overview is closed (`cat /sys/class/drm/card1/gt_act_freq_mhz` stays low). +- [ ] Two monitors: each has its own backdrop; unplugging/replugging one keeps the other working.