Skip to content
MoffKalast edited this page Jan 14, 2025 · 15 revisions

New to ROS?

The installation instructions presume that one of the following is installed:

You can find the setup instructions for Noetic in the main branch readme and Humble/Jazzy on the ros2 branch.

Β 

Getting started

Once the backend is launched (with one of the many options in the main readme), navigating to http://<host_ip>:5000 in your browser should display the web app client.

πŸ‘‰ Most widget icons open setup menus with a click, but some require a long press to open the menu and a single click to trigger actions.

Clicking the drawing button lets you add widgets to display and send data to ROS topics. Check the feature list for a rundown of all widgets and the messages they support, most are implementations of familiar visualizers seen in RViz.

Demo Videos

You can reference the list of demo videos for a better feel of how it all works in principle.

Advanced setup

If you need to host the server on another port, serve a stock config, or other custom changes, see the advanced config guide for tips and tricks.

Β 

ROS Distro support

Setup Noetic (ROS 1) Humble (ROS 2) Jazzy (ROS 2)
Vizanti + Rosbridge 🟒 🟑 🟑
Vizanti + RWS N/A 🟒 🟒

🟒 stable, all features should work

🟑 lower message throughput, higher CPU usage

❓ untested

πŸŸ₯ no support (yet)

Β 

Browser compatibility guide

Windows Linux MacOS iOS Android
Chrome βœ“ βœ“ ❓ N/A βœ“
Firefox βœ“ 🐒 ❓ N/A 🐒
Safari N/A N/A βœ“ βœ“ N/A

🐒 Slow rendering

❓ Untested

Vizanti should generally work with all browsers, and contains considerable hacky workarounds for e.g. Safari support on iOS without HTTPS.

In practice though, it's most often tested using Chrome on Android, Windows, and Ubuntu so those environments are likely to have fewer bugs and better performance.

If you are seeing unusually slow rendering in Chrome on Linux, set "Force color profile" to "sRGB" in chrome://flags/#force-color-profile. This should speed up canvas rendering.