FLOAT OSC Control @ vrch.ai

Somewhere between "open the ComfyUI page" and "actually touching the artwork" there's a gap, and the FLOAT OSC Control node is one of the things that closes it. You point an OSC app on your phone or tablet at your machine, move a fader, and a float anywhere in your workflow changes in real time. It's the general-purpose OSC input node of the ComfyUI Web Viewer pack, and you'll reach for it constantly once you start building interactive setups.

What it is

How it works is a straight remap pipe. It listens for OSC messages at server_ip:port on path, takes the raw value, and maps it from the input_min–input_max range onto your chosen output_min–output_max range. So an app that sends 0–1 gets stretched to, say, 0–100, and you never have to do that math in your head. output_invert flips the direction, output_default is the value it holds when no message has arrived yet (so your workflow starts somewhere sensible instead of at zero), and debug prints the traffic so you can see what's actually landing.

Two outputs, and they matter for different things. VALUE is the remapped float - the one you wire into a denoise, a CFG, a lerp factor, whatever eats a number. RAW_VALUE is the unmapped incoming OSC value, which is mostly for debugging and for cases where you want the raw signal for your own math. One fader in, one mapped float out; that's the whole contract.

The setup gotcha is identical to every OSC node in this pack: the default server_ip is 172.17.0.2, a Docker address from the dev environment that doesn't exist on your network. Change it to the IP of the device running your OSC sender - or 127.0.0.1 if the app is on the same machine as ComfyUI. The pack ships a ready-made TouchOSC layout (comfyui_osc_control.tosc in the repo) with faders pre-wired to sensible paths, which is the fastest way to get moving without designing your own panel.

How to install

Install: search "ComfyUI Web Viewer" in ComfyUI Manager, or

cd ComfyUI/custom_nodes
git clone https://github.com/VrchStudio/comfyui-web-viewer
cd comfyui-web-viewer
pip install -r requirements.txt

then restart. Windows portable: python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\comfyui-web-viewer\requirements.txt. Nothing heavy to download.

Common issues

Troubleshooting is the same checklist as the other OSC nodes: OSC is connectionless UDP, so "not working" almost always means wrong address, wrong port, or wrong path. Flip debug, watch the console - if RAW_VALUE doesn't move, the packet isn't getting there. Check the port matches your sender (8000 default), and confirm the path matches your OSC address rather than the /path placeholder. Once the fader moves, VALUE does the rest. And if you need to convert that value into a different range further down the line, the pack's FLOAT Remap node is the natural next hop.