View Bridge in Foxglove

Foxglove shows the Bridge receiver's camera, head and hands in one workspace. It uses the standard Foxglove application and its built-in panels. Start with Bridge setup and keep the Linux receiver running.

Open the workspace

From the public CERES checkout's receiver directory, install the Foxglove option in the receiver's Python environment, then start the output:

python -m pip install '.[foxglove]'
ceres-bridge foxglove

For Foxglove on another computer, use ceres-bridge foxglove --host <receiver-LAN-address>. The command prints a connection address, an Open in Foxglove link and a layout download address.

1. Open the printed Foxglove link, or choose Open connection > Foxglove WebSocket and enter the address.
2. Download the layout from the printed address. In Foxglove, choose Layouts > Import from file and select it.
3. On Quest, select Start streaming. Hold both hands in view and check that the connection and tracking indicators turn green.

The public layout files are also available directly. Use layout.json for H.264, vp8-layout.json for VP8 or ros-layout.json when connecting through ROS 2.

Read the display

Outward video appears beside the 3D scene. The scene shows the Quest headset, a blue left hand and a pink right hand when the receiver has the mesh assets installed. The camera image is projected in front of the headset. Tracking indicators report head and hand availability independently.

The tabs below the camera provide:

• Received video and motion rates, pose age, clock uncertainty and thumb-to-index distance.
• Head position and stream diagnostics.
• All 25 joints for each hand, including pose, radius and tracking validity.

Video and poses update independently. The camera projection uses the CERES Player Quest 3 preset until a measured calibration is supplied. The preset describes the image view and its offset from the headset.

Use headset and hand meshes

Start the output with the local viewer asset directory:

ceres-bridge foxglove --assets /path/to/bridge-viewer-assets

The directory contains quest-3.glb, mano-left.json and mano-right.json. Follow the receiver mesh guide to prepare these assets. The package keeps licensed mesh assets separate from its source distribution.

Pause and resume

Pause on the headset stops outgoing video and poses. Received rates fall to zero and tracking becomes unavailable. Resume starts fresh observations on the same paired connection. Exit stops the stream. The Foxglove workspace can stay open for reconnection.

For topic names, coordinate frames and projection parameters, see the Bridge Foxglove specification. For ROS 2, follow the ROS adapter guide.