Instant Queue Key Control @ vrch.ai
Press a key, kick off a generation — the performance trigger
Most of the ComfyUI Web Viewer pack is about steering a generation - scrubbing values, wiggling sticks, pulling faders. The Instant Queue Key Control node is about the other half of a live performance: triggering it. You press a key, and the workflow runs. It's the "hit the beat" node, the thing that turns "start generation" from a mouse click into a physical gesture.
What it is
The mechanism is queue control, not image processing - it has no image or value outputs at all. shortcut_key picks the trigger (a function key by default, F2, from a list of 24). queue_option picks the mode, and the three choices are the whole personality of the node:
- once - press the key, queue a single run. The "press to perform one generation" option.
- instant - press the key, run in ComfyUI's instant mode, which is the fast realtime path this pack is built around (auto-requeue as fast as the graph completes, ideal for interactive looping).
- change - run when something changes, so the queue follows your input state rather than a keypress.
Then there's the autorun pair: enable_queue_autorun turns on automatic re-queueing, and autorun_delay (1–60 seconds, default 5) sets the gap between runs. That's the "set it and let it generate while I play a controller" mode - the workflow keeps producing on its own, and you're free to drive the parameters with the pack's OSC, gamepad, or key control nodes in the meantime.
This is the node behind the README's "Auto Switch to Instant Queue and Run Workflow" example (example_others_002_autorun_instant_queue.json), and honestly it's the piece that ties the whole pack together. A FLOAT Key Control that scrubs a value is only fun if something actually re-generates when you press it - that's what this node's instant mode provides. The two nodes were designed to work as a pair: one changes the number, the other fires the pipeline.
How to install
Install is the pack-standard path:
cd ComfyUI/custom_nodes
git clone https://github.com/VrchStudio/comfyui-web-viewer
cd comfyui-web-viewer
pip install -r requirements.txt
restart ComfyUI. Manager users search "ComfyUI Web Viewer". Windows portable: python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\comfyui-web-viewer\requirements.txt. No models to download.
Common issues
One honest caveat, same as the other keyboard nodes: ComfyUI only receives the key when its window has focus, so this works great on a single-machine performance setup and falls apart if you're trying to trigger it while another app is in front - people have hit exactly that wall on r/comfyui. Keep the ComfyUI window visible, or go the gamepad/OSC route if you need triggers from anywhere. And start with autorun_delay on the high end (10–15s) while you're tuning - there's nothing like a runaway instant loop to make you appreciate the delay setting. Get it dialed in and you've got a one-key "go" button for your whole realtime setup.
Inputs (4)
| Name | Type | Default | Description |
|---|---|---|---|
| queue_option | COMBO | instant | 3 options: once, instant, change |
| shortcut_key | COMBO | F2 | 24 options: F1, F2, F3, F4, F5, F6, +18 |
| enable_queue_autorun | BOOLEAN | false | — |
| autorun_delay | INT | 51–60 | — |
Outputs (0)
No outputs