Attach companion files — TF2 demos, screenplay docs, transcripts, RAWs, anything — to your clips by a rule you define, and find them again in one click. A clip's detail view gains a Linked files panel (Reveal / Open / your own "Open with" programs); a new Linkers page lets you build rules from presets or from scratch with a live preview.
This is a general, domain-neutral system — a TF2 player attaching demos and a film editor pairing takes to screenplay .docx are the same feature.
How it works
Each linker is an Extract → Transform → Join → Resolve rule:
- Read each side (clip and file) into typed values — from the file name (a
%name%template), file dates, or metadata. - Transform those values with no-code steps (split, add, lowercase, read-as-date, combine…) — so
012matches12, or "demo seq = clip seq + 1" just works. - Match with plain-language conditions (equals / within N seconds / the file was recording when the clip happened / fuzzy text…).
- Resolve globally: keep all, best-per-clip, an optimal 1:1 pairing, a quota, etc. — with manual pin/exclude overrides that survive every re-run.
Three starter presets ship: Game demo (by recording time), Sidecar document (by number in the name), Any file recorded at the same time.
Links are automatic — when a scan adds new clips, the enabled linkers re-run and attach their files with no action from you (and again on window focus, if you turn that on).
Notes
- Companion files are never opened automatically — only when you click Reveal/Open. "Open with" runs a program you configure (path passed as a single argument, no shell).
- A missing target drive never wipes your links; a vanished file is flagged, not deleted.
- The whole matching engine is covered by an extensive test suite (filters, every resolution strategy, the global-optimum assignment vs brute force, unicode/spaces in names, and a large edge-case catalog).
Downloads
Clippycap-Setup.exe— installer (~104 MB). Bundles ffmpeg + offers the Edge WebView2 Runtime if missing.Clippycap-Portable.exe— one-file build (~20 MB). Downloads ffmpeg on first run.
v0.4.x users get this via the in-app update prompt.