For the complete documentation index, see llms.txt. This page is also available as Markdown.

Stage 3 · Live

For a returning installation, use the show checklist.

After setup, a show is four moves: open Settings, GO LIVE, monitor, and END LIVE.

Preview, then go live

Entering Settings starts the preview automatically — there is no separate start button. The sensors stream, and nothing is broadcast yet.

Give it 5–15 seconds to warm up. Starting the pipeline locks Calibration — the stage shows a 🔒 icon.

Select GO LIVE in the top bar. A readiness list appears. If it says NOT READY, complete the step it names; when it says READY, confirm GO LIVE in the panel. Output starts right away and the workspace switches to Live.

GO LIVE readiness panel
Complete the listed requirements before confirming GO LIVE.

First output check

For a first show, have one person enter the motion capture zone and walk, turn, and raise an arm. Setup is complete when /MOVIN/PointCloud keeps arriving in your receiving application and, for a tracked person, /VMC/Ext/Root/Pos and /VMC/Ext/Bone/Pos arrive too. If you have built a 3D view, compare its position, scale, direction, and motion against the performer. If messages arrive but the view is wrong, check the receiving integration against OSC message format before recalibrating sensors.

The Live stage

The Live stage is a monitoring screen for the running show.

The Live stage while broadcasting
The Live stage while broadcasting.

The top bar shows LIVE, the elapsed time, sensor status, tracked people, the OSC destination, and recording status. The viewport stays a live visual reference.

Two controls remain available here:

  • OSC output — the active destination. Source can be changed here and applies immediately. The target and port are set back in Settings.

  • Recording — capture the show to a file. See Recording for diagnosis.

If a sensor drops out mid-show

The show keeps running on the remaining sensors, with reduced coverage where the lost sensor was looking.

  • An alert appears in the viewport: LiDAR 204 offline — running on 4 of 5, reduced coverage.

  • The Sensors indicator in the top bar shows the same fraction.

Check the sensor's power and network cable.

If the sensor can't be brought back right now, select Acknowledge on the alert. The warning goes quiet for the rest of the run. The sensor list and the fraction keep showing the fact.

What you can change while live

Return to Settings at any time. What happens depends on the setting:

Setting
When it applies

Capture zones

Immediately for zone and human; all remains the full fused cloud

Background removal

Immediately for human and motion capture (learning needs the pipeline running); no effect on all or zone

Point cloud voxelization

Immediately

Motion smoothing

Immediately, in your show software — the viewport keeps showing the raw tracking

Source (all / zone / human)

Immediately — full fused / cyan zone / amber motion branch with background removal

World orientation

On Apply — immediately, no restart. The zones turn with the stage; the background must be learned again

OSC Target IP or port

On the Apply button that appears next to the edited target — output pauses for a moment, and you stay on air

Max tracked people

On the next Restart — processing and output briefly stop, then resume

Mocap backend

On the next Restart — processing and output briefly stop while the engine reloads

Calibration

Not while live. Select the Calibration stage marked 🔒 and confirm the stop to edit it

Recording for diagnosis

If something looks wrong, record it so the MOVIN team can reproduce and diagnose it.

  1. In the Live stage, select Recording → Record.

  2. Let it run while the problem is visible. The Rec indicator in the top bar shows a running clock.

  3. Select Stop, then Open folder to find the saved file.

A recording is an MCAP (.mcap) file with the raw point-cloud data from each sensor.

A recording still contains movement and spatial data. Handle and share it according to your organization's privacy and data-retention policies.

Ending the show

Select END LIVE in the top bar and confirm.

OSC output stops immediately and you return to Settings. Tracking and the point cloud keep running, so GO LIVE puts you back on air right away.

After the show, select Stop pipeline in the top bar. Sensor input, tracking, and OSC output all stop. It does not turn the machine off.

Shut down and pack away

  1. If recording, select Recording → Stop to finish saving.

  2. Confirm END LIVE, then select Stop pipeline.

  3. Open ⋯ → Server controls… → Shutdown, then confirm Shut down in the dialog.

  4. Wait until the server has fully powered off. A blank screen alone does not confirm it.

  5. Once shutdown completes, turn off the PoE switch and monitor, then disconnect cables for packing.

Use the server's physical power button to start it next time. Recalibrate after moving or packing away the sensors.

Last updated