WWW-POSIM v0.6.16Simulator documentation
Documentation menu
WWW-POSIM / Simulator documentation

RViz & Foxglove viewers

Open a read-only view of the sensors in your running world.

RViz Web (Lichtblick)

In a web server workspace, start your world and click Open at RViz in the workspace's Vehicle panel collapse bar. A new tab connects automatically and loads panels for the available sensors. RViz Web is WWW-POSIM's sensor viewer powered by Lichtblick. It needs no additional account, ROS installation or viewer installation.

Choose panels and graphs

Read-only access and limits

The connection is read-only. Publishing commands, changing parameters and calling robot services are blocked. Telemetry is limited to 5 messages per second per topic, 256 subscriptions per viewer and 2 MB per upstream message. This view is for inspection rather than full-rate recording. Public LIVE does not grant access to a private world's topics.

Native viewer displays

Waiting and reconnecting

If the viewer cannot connect, check that the workspace world is running and that login and usage access remain valid, then select Refresh. Capable hosts obtain a fresh grant for direct media-server access. After changing the world or robot, reopen the viewer from the workspace to obtain its current sensor list and layout. Check topic timestamps and updating graphs before treating a retained image as live data.

Built-in /model/wamv/... and /model/bluerov2/... examples can differ from vehicle-builder /vehicle/sensors/... topics. For a saved vehicle, inspect ROS topics or ros2 topic list and use those names in your code.

Connect Foxglove

The same ROS 2 data is compatible with Foxglove's Rosbridge connection:

  1. Open RViz Web (Lichtblick) from your running workspace.
  2. Click Foxglove Web or Foxglove Desktop in the viewer toolbar. WWW-POSIM supplies the connection address automatically. Install Foxglove first when using the desktop option.
  3. Sign in to Foxglove if requested. Direct connections require a Developer seat; see Foxglove's current connection requirements and plans.
  4. Connect within five minutes. If sign-in takes longer or a later reconnect fails, return to RViz Web and click the Foxglove button again to obtain a new address.

Connect manually

For manual setup, expand Foxglove connection URL after clicking a Foxglove button, copy the address, and choose Open connection → Rosbridge in Foxglove. This address uses the rosbridge protocol, so select Rosbridge rather than Foxglove WebSocket. The private address permits read-only access to the current world; do not share it. Logout, loss of the server slot or a world change ends access. A connected viewer can continue after the five-minute connection window while the same authorized session remains active.

Import a sensor layout

Lichtblick loads the generated sensor layout automatically. Foxglove users can click Download sensor layout and import the JSON through Foxglove's layout menu, or configure their own panels. Panel compatibility depends on the Foxglove version.

Installed app: open RViz

Start the simulator and run a workspace. In the local browser, select Workspace → RViz → Open RViz. The installed launcher must stay open. The Vehicle panel collapse bar also has an Open at RViz button. You can also select Open RViz beside Open ROS terminal and Open in VS Code. RViz opens in a separate window with the active vehicle's configuration and simulation clock. Its read-only connection displays telemetry without taking control of the vehicle.

First launch and requirements

RViz and its ROS/Qt dependencies are included in the app for Mac, Windows and Linux. A preparation window appears as soon as you open RViz and shows progress while the runtime and sensor connection are prepared. The first launch unpacks the visualizer into your user cache. No separate ROS or RViz installation is needed. Linux needs a graphical desktop with X11/XWayland. Closing RViz leaves the simulator and ROS terminal running.

Search documentation