feat(quickshell): add dense telemetry bar

2026-08-27 23:52:47 +00:00
parent 94061bd80a
commit 22fe8ab778
10 changed files with 1219 additions and 0 deletions
@@ -0,0 +1,39 @@
+# Headless Quickshell previews
+
+This directory provides a reproducible Docker wrapper around
+[qsmcp](https://github.com/fedsfarm/qsmcp). It renders a Quickshell `Item` to a
+PNG with Qt's `grabToImage()` without connecting to the host Wayland session.
+
+Both nixpkgs and qsmcp are pinned in `Dockerfile`. The runner uses
+`docker create` plus `docker cp` rather than bind mounts, so it also works with
+rootless/remote daemons whose mount namespace cannot see the checkout.
+
+## Smoke test
+
+Start Docker, then run from the repository root:
+
+```sh
+./tools/quickshell-preview/render.sh
+```
+
+The default output is:
+
+```text
+/tmp/homelab-quickshell-preview/smoke.png
+```
+
+## Render another Item-rooted component
+
+```sh
+./tools/quickshell-preview/render.sh \
+  tests/DenseBarHeadless.qml \
+  .artifacts/quickshell-preview/dense-bar-1920.png \
+  1920 164
+```
+
+The component path is relative to `dotfiles/quickshell`. Keep production
+`PanelWindow` wrappers thin and put their visual content in an `Item` component
+so it can be rendered through this offscreen path.
+
+`PanelWindow`-rooted previews require a nested compositor and are intentionally
+outside this first smoke-test image.