Nodes/ComfyUI Web Viewer/Instant Queue Key Control @ vrch.ai
ComfyUI Node

Instant Queue Key Control @ vrch.ai

Press a key, kick off a generation — the performance trigger

By VrchStudio·Created 2 years ago·Updated 19 days ago· 356
Instant Queue Key Control @ vrch.ai
      queue_optioninstant
      shortcut_keyF2
      enable_queue_autorunfalse
      autorun_delay5

      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.

      Categoryvrch.ai/control/keyboard

      Inputs (4)

      NameTypeDefaultDescription
      queue_optionCOMBOinstant3 options: once, instant, change
      shortcut_keyCOMBOF224 options: F1, F2, F3, F4, F5, F6, +18
      enable_queue_autorunBOOLEANfalse
      autorun_delayINT51–60

      Outputs (0)

      No outputs