Clipboard history picker: Omarchy shell plugin (tank.clipboard) with fuzzy search, rich previews, capture daemon

2026-09-05 15:25:15 +01:00
commit 44808ffd2c
17 changed files with 2982 additions and 0 deletions
@@ -0,0 +1,80 @@
+# clipboard-history
+
+A Raycast/vicinae-style clipboard history manager for Omarchy — implemented as
+an Omarchy shell plugin (`tank.clipboard`, a clone of `omarchy.clipboard`) so it
+rides on the system theme, fonts, and layer-shell infrastructure.
+
+## Features
+
+- **Rich capture** — a `wl-paste --watch` daemon records every clip with mime
+  type, byte size, source app (via `hyprctl`), timestamp, and image dimensions.
+  Text, images, and `file://` URI lists (file-manager copies) are supported;
+  password-manager clips and binary payloads are skipped.
+- **Fuzzy search over everything** — fzf-style scoring over content, source
+  app, and type, plus recency, pin, and usage boosts. Query tokens:
+  - `type:image|link|text|files|code|json|color|email|html|number` (prefix match)
+  - `app:firefox` — fuzzy match on the source app
+  - `is:pinned`, `today`, `yesterday`, `week`, `<2h`, `>30s`, `<3d`
+- **Raycast-style UI** — search bar with blinking cursor, type filter chips,
+  two-line result rows with type icons / image thumbnails and metadata
+  (type · app · age · size), and a right-hand preview pane:
+  - images rendered inline (with dimensions + size)
+  - colors shown as a swatch with hex/rgb/hsl values
+  - links show the domain headline
+  - JSON is pretty-printed; code/html shown appropriately
+  - file lists with paths; every preview shows metadata chips (app, date,
+    words/lines, bytes, pin/paste counts)
+- **Fully theme-integrated** — colors, spacing, corner radius, borders, and the
+  monospace font all come from the Omarchy shell's `Color`/`Style` singletons;
+  it re-themes itself on `omarchy theme set`.
+
+## Keys
+
+| Key | Action |
+| --- | --- |
+| `Ctrl+N` / `Ctrl+P` (or arrows) | navigate results |
+| `Enter` | copy to clipboard and paste into the focused window |
+| `Shift+Enter` | copy only |
+| `Ctrl+O` | open (link → browser, image → editor, file → xdg-open, text → editor) |
+| `Tab` | pin/unpin |
+| `Delete` | remove entry · `Shift+Delete` clear all (with confirm) |
+| `Esc` | clear filter, then close |
+
+## Install
+
+```bash
+./install.sh
+```
+
+This symlinks `plugin/` into `~/.config/omarchy/plugins/tank.clipboard`,
+rescans + enables the plugin (the built-in `omarchy.clipboard` is replaced —
+revert with `omarchy plugin disable tank.clipboard`), and rebinds
+`ALT+SHIFT+V` from vicinae to this picker (backing up `bindings.conf`).
+
+## Layout
+
+```
+plugin/
+├── manifest.json      # plugin manifest (clonedFrom omarchy.clipboard)
+├── Clipboard.qml      # picker overlay: search, chips, list, keys, capture watchers
+├── PreviewPane.qml    # per-type preview + metadata chips
+├── Store.js           # history model: dedup, pins, pruning, ids
+├── Fuzzy.js           # query parser, fuzzy matcher, scoring, highlighting
+├── Classify.js        # type detection, app names, formatting, color math
+├── capture.py         # clipboard watcher → one JSON line per clip
+├── paste-entry.sh     # copy + shift-insert paste into the focused window
+└── open-entry.sh      # open with the right app
+
+tests/                 # node --test suites for the JS logic
+```
+
+History is stored in `~/.local/state/omarchy/clipboard-history-rich.json`
+(image blobs content-addressed under `~/.local/state/omarchy/clipboard-images/`).
+
+## Development
+
+- Run logic tests: `tests/run.sh` (45 tests).
+- After editing files in the repo, reload with `omarchy-shell shell rescanPlugins`
+  (the plugin dir is a symlink, so the shell's inotify does not watch repo edits).
+- Data lives in `~/.local/state/omarchy/`; the picker state is independent of
+  the built-in clipboard plugin's `clipboard-history.json`.