Vivo Props — User Guide

The props

🏮

Lantern

Hand-held candle lantern — 7 LEDs, 18650 battery, RF remote scenes. The main fleet (20 units).

🏆

Chalice Fogger

The smoking chalice — 20 LEDs, driven by a simple on/off radio switch. Two fixed scenes: On and Off.

🪼

Jellyfish

Swimming jellyfish — 16 LEDs plus a motor with speed and direction control from RF scenes. Three units.

How it works

Every prop listens for its own set of remote-control button presses. Each button you pair fires a scene: a lighting look (colour + effect), a motor speed on props that have one, or both at once. Scenes are set up from the prop's own web page and saved on the prop — once configured, the prop works with no network at all.

A scene can change one thing, or everything

Each scene sets the lights, the motor (where fitted), both — or deliberately leaves one alone (no change). So one button can start the jellyfish swimming without touching its glow, and another can change the glow without interrupting the swim. The all off button in the scene editor builds a blackout scene that explicitly stops everything.

Finding a prop's web page

Power the prop on. If it already knows your venue WiFi, it joins it — find its address on your router, or use the fleet page of any other prop (below) to spot it.
If it has no WiFi configured (or can't reach it), the prop raises its own hotspot named after itself — vivo-prop-…, vivo-fogger-… or vivo-jelly-…. Join it from a phone (ask your production tech for the props password) and a setup page pops up automatically — or browse to http://192.168.4.1.
From the setup page, add your venue WiFi under WiFi and save — the prop reboots onto the network.

The WiFi section: a saved network with password, and a scan list of nearby networks with signal strengths — Scan networks lists what the prop can hear — tap one to fill a WiFi slot.

The web page shows a status line: signal strength, free memory, uptime — and a heartbeat dot next to the prop's name that pulses every couple of seconds while the connection is live. If the dot goes red, the page has lost the prop; it reconnects by itself when the prop is back.

Show mode: WiFi switches itself off

By default, the first remote press of the night turns the prop's WiFi off — deliberately. It makes button response instant and saves battery through the show. The web page shows a 10-second countdown first with a Keep WiFi on button if you're mid-edit. WiFi comes back on the next power-cycle — that's normal, not a fault.

For rehearsals and setup sessions, untick Disable WiFi on RF press in Settings so the prop stays reachable while you work.

The web page, tour

A prop's web page: status line, six scene cards named White, Red, Green, Blue, Candle and Off, and collapsed Palette, Fleet, WiFi, Settings and Firmware sections — A lantern's page: status line, scene cards, and the collapsible sections below. The green dot by the name is the heartbeat.

Section	What it does
Slots	Your scenes. Each card holds the remote codes that trigger it plus what it does: lights (a palette colour + optional effect, or off, or no change) and, on the jellyfish, a motor speed. Test fires the scene right now.
Palette	The shared colour list scenes pick from. Click a swatch for a picker — the prop previews the colour live as you drag.
Fleet	Finds the other props on the network; pushes settings or firmware to them; renames them. See Fleet.
WiFi	The networks the prop tries at power-on, in order.
Settings	Prop name, group, show-mode WiFi toggle — and on motor props, the motor calibration.
Firmware	Shows the running version; updates are normally pushed from one prop to the rest via Fleet.

The Palette section: five named colours with RGB values and swatches, plus an add-colour button — The palette — the shared colour list every scene picks from.

Nothing is saved until you press Save to prop. Edits (and Test presses) are safe to experiment with.

Fleet: many props, one screen

Open any prop's page, expand Fleet, and press Scan for props. Every powered, connected prop answers with its name, address, version and type. From the table you can:

Rename a prop or set its group right in the table — edit the field and press the green ✓.
Push config — copy this prop's scenes/palette to others of the same type (each keeps its own name and, on motor props, its own motor calibration).
Push firmware — update others of the same type to this prop's version. The list clears while they reboot, then re-scans.

Groups

A group name (e.g. lantern-silver, fogger1) limits config pushes: a prop with a group set only accepts pushes from the same group, and a prop with no group adopts the group of the first push it receives. The line at the top of the Fleet section always tells you exactly what a push from that prop will reach. Firmware pushes ignore groups but never cross prop types — a lantern can't flash a fogger.

Troubleshooting

Symptom	Likely cause and fix
Prop vanished from WiFi mid-show	Show mode did its job — a remote press turned WiFi off. Power-cycle the prop when you next need the web page.
Heartbeat dot red	The page lost the prop (rebooted, WiFi off, or out of range). It reconnects automatically — if it stays red, power-cycle the prop.
Can't find the prop's address	Scan from another prop's Fleet page, or check your router's client list for `vivo-…` names.
Remote button does nothing	Check the scene's card lists a captured code (lantern/jellyfish); check battery; remember a held button only fires once until released.
Prop starts in hotspot mode	It couldn't reach any saved WiFi. Join the hotspot and fix the network list — or just use it there; scenes work regardless.