node-red-contrib-virtuino

Node-RED nodes for Virtuino Cloud — send and receive live values to/from your account's fields without typing an MQTT topic by hand.

Nodes

• virtuino-config — one config node per Virtuino Cloud account (Sub-account Key + MQTT password, optional Client ID). Every virtuino out / virtuino in node reuses it, over a single connection.
• virtuino out — publishes msg.payload to a field. The topic is the field's full name, e.g. esp32/temperature. Objects are sent as JSON, everything else as a plain string.
• virtuino in — subscribes to a field (wildcards +/# supported, e.g. esp32/#) and outputs msg.topic / msg.payload whenever a new value arrives.

Both node editors have a "Fetch from Cloud" button that lists your fields and fills in the topic for you.

Client ID

Virtuino Cloud shows every connection in My Virtuino World under its client ID, and the device status widget watches it by that name. The connection keeps the same client ID across deploys and Node-RED restarts: the one you type in the config node, or — if you leave it empty — nodered- followed by the config node's id. Give every Node-RED that connects to your account its own client ID; two connections with the same one keep disconnecting each other.

Install

cd ~/.node-red
npm install node-red-contrib-virtuino

Then restart Node-RED. A new "Virtuino" category appears in the palette.

Or from the editor: menu (☰) → Manage palette → Install → search node-red-contrib-virtuino.

Quick start

1. Drag a virtuino out node onto the canvas, open it.
2. Next to Account, click the pencil to add a config node — enter your Sub-account Key and MQTT password (find both in the Virtuino Cloud console under Keys & Sub Users).
3. Deploy.
4. Reopen the node, press Fetch from Cloud, pick a field — the topic fills in automatically.
5. Wire an inject node into it and deploy — the value now updates live on your Virtuino Cloud dashboard.

For the full walkthrough (including receiving dashboard commands with virtuino in, and bridging Modbus devices via node-red-contrib-modbus), see the Get Started guide.

License

MIT