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).

Straight into a recording. Pass --input to open a .vynt file at startup instead of the file picker:

voyant_visualizer --input car_parking-v1_0_0.vynt

Options

Run voyant_visualizer --help for the full list.

• --input <FILE> — recording (.vynt) to open at startup instead of the interactive file picker. Cannot be combined with the connection arguments below.
• --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.
• --diagnostic-mode — connect in diagnostic mode: frames keep invalid points (with drop reasons), and recording also writes a raw-peaks sidecar for Voyant support.
• --keep-invalid-points — start with the playback “Show invalid points” toggle on.
• --carbon-config-path <FILE> — optional Carbon JSON config to load on connect. Network fields are always overridden by the arguments above when present.

There are three ways to launch: with no arguments for interactive mode, with --input to open a recording, or with all three connection arguments — which are required together — to start live. --input and the connection arguments are mutually exclusive.

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