SDK Operating Modes
There are many different ways of sending data to the Rerun Viewer depending on what you're trying to achieve and whether the viewer is running in the same process as your code, in another process, or even as a separate web application.
In the official examples, these different modes of operation are exposed via a standardized set of flags that we'll cover below. We will also demonstrate how you can achieve the same behavior in your own code.
The Rerun SDK provides 4 modes of operation:
All four of them are optional: when none of these modes are active, the client will simply buffer the logged data in memory, waiting for one of these modes to be enabled so that it can flush it.
This is the default behavior you get when running all of our Python & Rust examples, and is generally the most convenient when you're experimenting.
rr.spawn once at the start of your program to start a Rerun Viewer in an external process and stream all the data to it via TCP. If an external viewer was already running,
spawn will connect to that one instead of spawning a new one.
Session::spawn spawns a new viewer on the main thread (for platform compatibility reasons) and continues executing user code on a new thread, streaming data between the two in real-time using an in-memory channel.
Connects to a remote Rerun Viewer and streams all the data via TCP.
You will need to start a stand-alone viewer first, either by using
python -m rerun if you've installed via
pip, or simply
rerun if you've installed via
This starts the web version of the Rerun Viewer in your browser, and streams data to it in real-time using WebSockets.
Make sure you have enabled the
web feature when building, and then call
Saves all the data buffered so far into an
rrd file on disk, which can then be loaded into a stand-alone viewer.
To visualize the saved file, use
python -m rerun path/to/file.rrd if you've installed via
pip, or simply
rerun path/to/file.rrd if you've installed via
⚠️ RRD files don't yet handle versioning! ⚠️
Adding the standard flags to your programs
We provide helpers for both Python & Rust to effortlessly add and properly handle all of these flags in your programs.
- For Python, checkout the
- For Rust, checkout our
Have a look at the official examples to see these helpers in action.