Visualize: voyant_visualizer

Interactive 3D point-cloud viewer for live and recorded data.

The visualizer is the primary interactive tool for working with a Voyant sensor: connect to a live sensor, open a recording, adjust the view, configure the sensor, and record data — all from one GUI.

For a full walkthrough of the interface, see the Visualizer Guide. This page covers how to launch the tool and its command-line options.

Launching

From your desktop. Installing the Debian package adds a Voyant Visualizer entry to your application menu — search for it and open it, or double-click it. On Linux you can also pin it to your favorites / sidebar for one-click access.

From a terminal. Launch with no arguments to open the GUI (connect to a sensor or open a recording from there):

voyant_visualizer

Straight into a live stream. Provide all three connection arguments to skip the connect dialog and begin streaming immediately — handy for scripts and demos:

voyant_visualizer --bind-addr 0.0.0.0:5678 --group-addr 239.255.48.84 --interface-addr 192.168.1.100

To watch a sensor another client already owns, add --observer-only (passive receive — sends nothing to the sensor).

Options

Run voyant_visualizer --help for the full list.

--bind-addr <ADDR> — local address to bind to (e.g. 0.0.0.0:5678).
--group-addr <ADDR> — multicast group address to join (e.g. 239.255.48.84).
--interface-addr <ADDR> — local interface IP for the multicast group (192.168.1.100 for a live sensor, 127.0.0.1 for the simulator).
--observer-only — passively receive the stream without sending anything to the sensor. Use when another client owns it.
--stream-transport <unicast|multicast> — how the sensor delivers its stream: unicast (default; reliable for a single client) or multicast (a shared group for several clients). Ignored by observers.
--carbon-config-path <FILE> — optional Carbon JSON config to load on connect. Network fields are always overridden by the arguments above when present.

The three connection arguments are required together. Launch without them to open in interactive mode.

Launching from the desktop always opens interactive mode; use the Open Connection… dialog to connect, where connection presets (Carbon, Carbon Sim, Meadowlark Legacy) fill in the right defaults. See the Visualizer Guide for the rest.