ComfyUI-LinkSpotlight v1.2.0
The spotlight grows up: buttons everywhere, a real graph traversal, and new
ways to trigger it — including one that needs no shortcut at all.
✨ New
Toggle it from anywhere
- Topbar button — a 👁 Spotlight button next to the settings group.
It doubles as a permanent indicator: gold with a filled eye while the
spotlight is active. - Selection toolbox — the toggle appears in the floating bar above
selected nodes, exactly when it is usable. - Node right-click menu — 🔦 Spotlight links on any node (selects it
if nothing was), plus a Link Spotlight off escape hatch in the canvas
menu while active. - On-canvas pill (optional) — shows the current depth/direction while
the spotlight is on, so hidden links are never a mystery.
Smarter focus traversal
- Depth — 1, 2, 3 hops from the selection, or ∞ for the full trace
(every ancestor/descendant). - Direction — both ways, upstream (where the data comes from) or
downstream (where it goes). Combine with ∞ to trace a full lineage. - Reroutes are free — Reroute nodes are traversed as pass-throughs and
never consume a hop. - Groups — selecting a group spotlights every node inside it.
New spotlight behaviors
- Hidden-links override — with the canvas hide links button on,
selecting node(s) reveals their links automatically, no shortcut needed;
clear the selection and everything hides again (opt-out setting). - Hover mode (opt-in) — with nothing selected, the spotlight follows
the node under the cursor. Works in Vue nodes mode ("Nodes 2.0") too. - Focus emphasis — optionally draw the spotlighted links thicker
and/or with a golden glow.
Deeper dimming
- Node dimming now also covers widgets and bypassed/muted/ghost
nodes, and groups holding nothing in focus dim with the rest.
🐛 Fixes
- Fixed an alpha-collision bug where dimming was silently skipped for
bypassed/muted/ghost nodes at certain opacity settings (e.g. 0.2). - Hover tracking and the activity indicator no longer depend on the front
canvas render pipeline — they now work in every render mode, including
the Vue nodes beta.
🔧 Internals
- Code split into side-effect-free ES modules (
state/focus/
render/topbar+ entry). - 5 new settings under Settings → LinkSpotlight; all existing setting
ids and defaults are preserved — no migration needed.
❤️ Credits
The hidden-links override and the extended node/group dimming were
contributed by Kieran Marien
(buzzworks-be fork),
ported onto the new module layout and hardened. Thanks!