aboutsummaryrefslogtreecommitdiffstats
path: root/desktop/modules/clipboard/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-15 11:28:32 +0200
committerDanilo M. <danix@danix.xyz>2026-10-15 11:28:32 +0200
commit3345afa2ae8f9c8159548fc23e5b4bf8f1fd9035 (patch)
tree5daea028a2e48d6e44f50027687288553cba792e /desktop/modules/clipboard/README.md
parent98fc6036ee817a92810e060c80d48aa6a936a1ab (diff)
downloadquickshell-3345afa2ae8f9c8159548fc23e5b4bf8f1fd9035.tar.gz
quickshell-3345afa2ae8f9c8159548fc23e5b4bf8f1fd9035.zip
feat(desktop): performance and clipboard pages, a scrolling tile grid
The tile grid sits in a Flickable capped at three rows, so the fourth row the new modules bring scrolls inside that box instead of eating the notification space; a thin accent bar in the margin shows only when a row is hidden. Tiles are reordered with the everyday ones first. Performance shows the island's PerfPanel in a Page, with a tile line of CPU and RAM and the warning dot. Perf.detailed is now a count of live PerfPanel instances instead of a binding in the status pill: the island and the drawer both host the panel, and a bool with two writers would let one clear it under the other. Clipboard reads cliphist when its page opens: search, copy on click or Enter, delete per row, clear all behind a 3 second confirm, image entries as thumbnails decoded once onto tmpfs. Entries reach sh as $1, never inside a command string. A copy closes the drawer through a new Page.dismiss signal the drawer connects like back. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'desktop/modules/clipboard/README.md')
-rw-r--r--desktop/modules/clipboard/README.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/desktop/modules/clipboard/README.md b/desktop/modules/clipboard/README.md
new file mode 100644
index 0000000..4502349
--- /dev/null
+++ b/desktop/modules/clipboard/README.md
@@ -0,0 +1,29 @@
+# clipboard
+
+The clipboard history as a drawer page, replacing the rofi list. The history
+itself is cliphist's, fed by `wl-paste --watch cliphist store` from autostart;
+this module only reads and edits it. CTRL+SHIFT+L opens the drawer straight on
+this page (`ipc call drawer open clipboard`).
+
+- The search field has focus on open and filters as you type, ignoring case.
+- Up and Down move the highlight; Enter or a click copies the entry and closes
+ the drawer.
+- `×` on a row deletes that entry; "Clear all" asks once more ("Confirm?",
+ 3 seconds) and then runs `cliphist wipe`.
+
+Nothing runs while the drawer is closed: the page runs `cliphist list` when
+it opens. 750 entries measured, 42 of them images.
+
+**Entries are untrusted text.** Copy and delete pass the cliphist line to
+`sh -c` as `$1` and print it into `cliphist decode` or `cliphist delete`; it
+never becomes part of a command string.
+
+**Images show as thumbnails.** A row whose preview is cliphist's
+`[[ binary data <size> <type> <WxH> ]]` decodes the entry once into
+`$XDG_RUNTIME_DIR/qs-clip/<id>.png` and reuses the file after. That directory
+is tmpfs, so a reboot clears it. The list is a `ListView`, so only rows that
+are created decode.
+
+`Clip.js` holds the parsing and the filter, tested with:
+
+ node desktop/modules/clipboard/test_clip.js