voyant_foxglove_bridge

Connect live sensor data streams to Foxglove Studio for real-time visualization. Creates a WebSocket server that converts Voyant data to Foxglove format.

Use voyant_foxglove_bridge --help to see all available options.

Usage

Live Sensor Data

voyant_foxglove_bridge --bind-addr 0.0.0.0:4444 --group-addr 224.0.0.0 --interface-addr 192.168.20.100

Mock Data Visualization

For simulation environments with voyant_points_mock_stream:

voyant_foxglove_bridge --bind-addr 0.0.0.0:4444 --group-addr 224.0.0.0 --interface-addr 127.0.0.1

Custom WebSocket Port

voyant_foxglove_bridge --ws-port 9000 --bind-addr 0.0.0.0:4444 --group-addr 224.0.0.0 --interface-addr 192.168.20.100

For more detailed Foxglove user instructions, please see our Pointcloud Visualization guide.

Expected Output

When successfully connected:

Starting frame receiver...
Converted receiver to async mode
Starting foxglove websocket on port 8765...

When stopped:

Received SIGINT (Ctrl+C)
PointsClient shutting down
  Total processed frames: 14
  Total dropped frames:   0
  Total dropped point groups: 0

Connect to ws://localhost:8765 in Foxglove Studio to view the live visualization.

Options

  • --ws-port <PORT> - WebSocket port for Foxglove connection (default: 8765)
  • --check-interval <MS> - Frame check interval in milliseconds (default: 10)
  • --keep-invalid-points - Include invalid points in visualization

Troubleshooting

If visualization fails:

  • Verify sensor connectivity and data stream
  • Check that the WebSocket port isn’t already in use
  • Ensure Foxglove Studio can connect to the WebSocket address
  • Monitor the frame statistics when stopping to verify data flow

Copyright © Voyant Photonics, Inc.