This is a prerelease. It is not intended for production use.
Please report any issues you find.

Example Hosted App

https://rerun.io/viewer/commit/675616d

Wheels can be installed with:

pip install --pre --no-index -f https://build.rerun.io/commit/675616d/wheels --upgrade rerun-sdk

or

pip install --pre --no-index -f https://github.com/rerun-io/rerun/releases/download/prerelease --upgrade rerun-sdk

CMake fetch-content for C++ SDK

include(FetchContent)
FetchContent_Declare(rerun_sdk URL https://build.rerun.io/commit/675616d/rerun_cpp_sdk.zip)
FetchContent_MakeAvailable(rerun_sdk)

or

include(FetchContent)
FetchContent_Declare(rerun_sdk URL https://github.com/rerun-io/rerun/releases/download/prerelease/rerun_cpp_sdk.zip)
FetchContent_MakeAvailable(rerun_sdk)

Web Viewer NPM package

Can be installed with:

npm install https://build.rerun.io/commit/675616d/rerun_js

Rerun is an easy-to-use database and visualization toolbox for multimodal and temporal data.
Try it live at https://rerun.io/viewer.

• Python: pip install rerun-sdk
• Rust: cargo add rerun and cargo install rerun-cli --locked
• Online demo: https://rerun.io/viewer
• C++ FetchContent: https://github.com/rerun-io/rerun/releases/download/0.25.1/rerun_cpp_sdk.zip

This is a pure bugfix release!
For release notes on all changes in 0.25.0, go here.

• Fix vector search #11259
• Fix space origin editor resetting & closing immediately #11251
• Fix some menu buttons closing unexpectedly #11247
• Fix table UI not saying switch to when opening a certain links #11237
• Use short name in component defaults menu #11264

Rerun is an easy-to-use database and visualization toolbox for multimodal and temporal data.
Try it live at https://rerun.io/viewer.

• Python: pip install rerun-sdk
• Rust: cargo add rerun and cargo install rerun-cli --locked
• Online demo: https://rerun.io/viewer
• C++ FetchContent: https://github.com/rerun-io/rerun/releases/download/0.25.0/rerun_cpp_sdk.zip

• 🧳 Migration guide

✨ Overview & highlights

Syntax highlighting

Our data frames and selection panel now feature prettier colors based on data types.

Table filtering

We are busy working on a powerful filtering feature for our arrow dataframe widget used for tables (sent with ViewerClient.send_table()) as well as the Rerun server browser (entry list, partition list, and remote tables). This release introduces support for filtering boolean, integer, floating point, and string columns, with more coming in future releases. (Note that the text log views and dataframe views are using a different widget which does not support filtering.)

Transparent objects

We finally support transparency for meshes & various shapes (boxes, ellipsoids, etc.)!

Source of transparency ("alpha") is a bit limited for now:

• color component on all of Boxes3D, Ellipsoids3D, Capsules3D & Cylinders3D
• Mesh3D's albedo factor
• Asset3D albedo color (depends on the underlying model format)

Naturally, there's still a lot of places missing where we'd like to add transparency support!

Experimental MCAP support

Rerun has experimental, partial support for importing data from MCAP files. We support a subset of ROS2/CDR and Protocol Buffers messages. Development is ongoing, feel free to share your use cases!

⚠️ Breaking changes

We removed the --serve, --drop-at-latency and -o CLI arguments, deprecated Python 3.9 and changed archetype specification in AnyValues.

We also removed flush_timeout_sec parameter to out connect functions. Instead you can specify a maximum wait time in the calls to flush, but usually this isn't needed, as the new blocking behavior is also much smarter.

See the
🧳 Migration guide for more details.

🔎 Details

🪵 Log API

• Add explicit timeout to flush API #11008
• Make archetype and URDF loaders honor entity_path_prefix #11085
• Keep static log messages longer in the proxy #11091

🌊 C++ API

• Fix flush_blocking destroying C++ recording stream #10885
• Respect CMAKE_BUILD_TYPE when building the Rust code #11023
• Add options to gRPC proxy server to replay newest data first #11118
• Prevent arow_cpp from configuring/building/installing all the time #11093 (thanks @eliemichel!)

🐍 Python API

• Add __len__ to codegened Python datatypes #10774
• Remove '-o' shorthand for stdout from script_add_args #11043 (thanks @kabouzeid!)
• Deprecate python 3.9 #11090
• Bump datafusion-python to 48.0.0 #11089
• Improve numpy 1 compatibility #11129 (thanks @Benjamin-Tan!)
• Split AnyValues into AnyValues and DynamicArchetype #11045

🦀 Rust API

• Update MSRV to 1.88 #10832
• Split AnyValues into AnyValues and DynamicArchetype #11045

🪳 Bug fixes

• Fix panic on bad STL files (e.g. for URDFs) #10855
• Fix Ellipsoids3D archetype not showing in 2D view projections #10922
• Fix unwanted eye (camera) movement when using shortcuts #8975 (thanks @kailiuca!)
• Fix opacity heuristic for images/segmentation when scene changes #11014
• Fix 3D eye camera reset not resuming tracking scene bounding box #11037
• Fix mesh cache eviction issue #11079
• Fix recording to split in two when loading an URDF #11086
• Fix for single channel textures displayed only in the red channel #11101
• Fix columns menu closing on click #11119
• Fix sharing selection as a fragment #11161
• Fix UI glitch when connected twice to the same server #11185
• Fix tooltips sometimes being way too big #11190
• Fix incorrect application id when dragging and dropping files #11197
• Fix wrong rendering of some texture formats in light mode #11225

🌁 Viewer improvements

• Integrate basic MCAP loader from rerun-io/rerun-mcap #10721
• Support scroll-/pinch-to-zoom with first person eye control #10783
• Low-level Arrow conversion of protobuf-encoded MCAP messages #10791
• Support flexible x-axis for bars in BarChart #10675 (thanks @Xiao-Chenguang!)
• Customize color and line width of Pinhole camera frustum #10842
• CLI now consistently forward URLs to native/web viewer when possible #10909
• Fix closing recordings/tables that are still being loaded showing up again #10963
• Persist fallback token #10970
• Allow opening web viewer links directly #10928
• Add keyboard shortcut to copy entity hierarchy #10938
• Add H.265 support for native & VideoStream #10994
• Support sharing URLs for dataplatform datasets & tables #11038
• New open from URL dialog & main menu entry #11040
• Add archetypes for MCAP metadata #11062
• Add opacity setting for VideoStream & VideoAsset #11113
• Add MCAP parsers for scalar sensor messages #11078
• Remove custom number formatting on copy #11148
• Implement fallback mode for raw MCAP layer #11136
• Support basic transparency for Mesh3D/Asset3D/Boxes3D/Ellipsoids3D/Capsules3D/Cylinders3D #11132
• New link sharing dialog for detailed link sharing #11137

🚀 Performance improvements

• Prevent 100% CPU Usage when running gRPC server by sleeping instead of yielding #10944 (thanks @nisseknudsen!)

📚 Docs

• Fixed highlighting of Python code in docs #10920 (thanks @YohDeadfall!)
• Correct 'altitude' to 'latitude' in documentation #10998 (thanks @skalldri!)
• Added release calendar for Python #11081

🖼 UI improvements

• Log all low-level MCAP primitives + raw messages as fallback #10769
• Add arrow data tree view and syntax highlighting #10777
• Add debug information about caches on the memory panel #11055
• Implement full text filtering for string-based columns of the table widget #11061
• Add support for filtering on boolean columns #11095
• Add support for filtering numeric (int/float) columns in tables #11142
• Use partition id in the recording panel #11157
• Draw loop selection highlight on ...

Rerun is an easy-to-use database and visualization toolbox for multimodal and temporal data.
Try it live at https://rerun.io/viewer.

• Python: pip install rerun-sdk
• Rust: cargo add rerun and cargo install rerun-cli --locked
• Online demo: https://rerun.io/viewer/version/0.24.1/
• C++ FetchContent: https://github.com/rerun-io/rerun/releases/download/0.24.1/rerun_cpp_sdk.zip

🌊 C++ API

• Fix rerun_cpp CMake link errors #10756 (thanks @reinar!)
• Fix C++ interface for VideoStream #10745
• Fix C++ Arrow build #10799

🐍 Python API

• Explicitly import pyarrow.compute in url_generation.py #10690
• Add rerun-sdk[datafusion] and rerun-sdk[all] #10696

🦀 Rust API

• Fix unnecessary rfd and wayland dependencies in SDK crate #10802

🪳 Bug fixes

• Make parking_lot dependency version stricter to prevent import failure #10732 (thanks @sdd!)
• Use ui.warning_label() in more places #10697
• Fix colors sometimes being wrong in plot view #10713
• Fix breaking example in rerun_notebook/example.ipynb #10706 (thanks @glk0!)
• Fix GUI hickup when starting native video player #10797
• Improve command palette in light mode #10825

🌁 Viewer improvements

• Add time range query params when opening a time_range-based url #10819

🖼 UI improvements

• Better component UI for Arrow StructArray #10748

🕸️ Web

• Make @rerun-io/web-viewer-react compatible with React 19 #10809

📈 Analytics

• Add some analytics events #10793

Rerun is an easy-to-use database and visualization toolbox for multimodal and temporal data.
Try it live at https://rerun.io/viewer.

• Python: pip install rerun-sdk
• Rust: cargo add rerun and cargo install rerun-cli --locked
• Online demo: https://rerun.io/viewer/version/0.24.0/
• C++ FetchContent: https://github.com/rerun-io/rerun/releases/download/0.24.0/rerun_cpp_sdk.zip

• 📖 Release blogpost
• 🧳 Migration guide

✨ Overview & highlights

💽 Tagged components

Starting with 0.22 Rerun began storing additional meta-information for each component,
identifying its field name (e.g. vertex_colors) and its archetype (e.g. Mesh3D).
We finally concluded this effort and made all parts of the Viewer and API aware of this.

While this is mostly about under-the-hood changes, this has a lot of surface level benefits:

• You can now log the same component type multiple times on a single entity path.
  For example, logging multiple archetypes which use the Color component onto the same entity was possible before, but the colors would have overwritten each other:

rr.log("path", rr.GeoPoints(lat_lon=[some_coordinate], colors=[0xFF0000FF]))
rr.log("path", rr.Points2D(positions=[0.0, 0.0], colors=[0x0000FFFF]))
rr.log("path", rr.Mesh3D(vertex_positions=vertices, vertex_colors=[0x00FF00FF]))

• The UI now groups by archetype everywhere and will show the same field names you use in the logging SDKs
  
• Better blueprint defaults: component defaults are now per archetype field and not per type. Making them a lot more useful.
  
• No more indicator components! These showed previously up in the UI and needed special handling for some advanced use cases.

🎥 Video streams

Rerun previously supported video only in the form of MP4 files,
so it was not possible to stream live encoded video to Rerun.
The new VideoStream archetype remedies that!

If you already have encoded video frames, it is just as easy as logging images now:

rr.set_time("time", duration=float(packet.pts * packet.time_base))
rr.log("video_stream", rr.VideoStream(codec=rr.VideoCodec.H264, sample=bytes(packet)))

For now, we only handle H.264, but support for more codecs is on the roadmap.
Learn more on the updated video reference page.

😎 Light mode

Rerun finally has a light mode.

The theme defaults to your OS's setting, but can be adjusted in the settings menu.

🔀 Multi sink

Previously, the SDK's recording stream could only send to one sink at a time.
We now expose the ability to set multiple sinks at once, so you can simultaneously
stream to both the Viewer and a file.

Here's what that looks like in Python (but the API is available in C++ & Rust as well!)

rr.set_sinks(
    # Connect to a local viewer using the default URL
    rr.GrpcSink(),
    # Write data to a `data.rrd` file in the current directory
    rr.FileSink("data.rrd"),
)

🤖 Built-in URDF data loader

You can now log URDF files directly to Rerun using the log_file API.

👀 Other highlights in short

• New Cylinder archetype
• AnyValues utility for Rust
• rerun rrd stats for retrieving statistics about rrd files
• rerun rrd route command to manipulate .rrd files on transport level
• Much faster & better compaction for both rerun rrd compact and automatic in-Viewer compaction
• Viewers started with spawn use now less memory since it no longer sets up an GRPC server for message forwarding
• View3D's eye control type & speed can now be changed from blueprint (and as such is persisted over session!) more properties will follow in the future. (thanks to @jccampagne)

🔎 Details

🪵 Log API

• Remove deprecated Scalar, SeriesLine, SeriesPoint archetypes #9892
• Remove untagged Component::descriptor() #10038
• Add Cylinders3D archetype #10139
• Provide AnyValues helpers in Rust SDK #10074
• Rename ComponentDescriptor fields and use colons in Sorbet metadata #10245
• Stop logging indicators and drop them during migration #10521
• Make SeriesPoints::markers component required #10572
• Remove indicators from codegen, rerun_py, and rerun_cpp #10581
• Removes remnants of indicators from dataframe queries and viewer #10584
• rerun rrd stats #10593
• Source default batcher settings from sink #10620

🌊 C++ API

• (CMake) download arrow inside the rerun build folder instead of general binary folder #10141 (thanks @jzubizarreta!)
• Fix documentation wording on which arrow-cpp version to use #10235
• Disable gRPC server history for Spawn/CLI #10314
• Add set_sinks to C++ RecordingStream #10359

🐍 Python API

• Add Dataset.register_batch and wrappers for task ids #9895
• Introduce ConnectionRegistry for centralised redap client and token management #10078
• Build in manylinux_2_28 container #10148
• Add APIs to Dataset to query and update the associated blueprint #10156
• Support for seconds-since-Epoch numpy arrays for constructing TimeColumn #10168 (thanks @MichaelGrupp!)
• Fix initializing two recordings with the same recording id causing SDK hangs #10201 (thanks @AhmedMousa-ag!)
• Improve rerun_notebook startup times #10111
• New dataset API for just retrieving chunk_ids associated with a query #10261
• Multi-sink / tee Python API #10158
• Rename to tee to set_sinks #10312
• Add support for index=None to local and remote dataframe APIs and deprecate select_static #10332
• Disable gRPC server history for Spawn/CLI #10314
• Deprecate serve_web and improve documentation around how to serve a web viewer #10360
• Add partition ID to TimeUpdateEvent #10403
• Fix set_time_ctrl not doing anything when called twice #10547
• Notebook auto-sizing #10554
• Add RegisterTable rpc, LanceTable message, and related proto changes #10538
• Add open_url/close_url notebook APIs #10602
• AnyValue Torch Performance Improvement #10647
• Make it easier to disable the 3D line grid in Python (blueprint) #10621
• Add to_arrow_reader() to TableEntry and DataFusionTable #10601
• Make it possible to configure batcher explicitly via python APIs #10657

🦀 Rust API

• Update MSRV to 1.85 #9798
• Improve rerun crate forwarding, removing need to depend on other re_* crates for viewer customization [#9825](https://github.com/r...

This release is a pure bugfix release for migration of old RRD files in how meta-data keys for archetypes & field names were handled.

For details see #10350

Rerun is an easy-to-use database and visualization toolbox for multimodal and temporal data.
Try it live at https://rerun.io/viewer.

• Python: pip install rerun-sdk
• Rust: cargo add rerun and cargo install rerun-cli --locked
• Online demo: https://rerun.io/viewer/version/0.23.3/
• C++ FetchContent: https://github.com/rerun-io/rerun/releases/download/0.23.3/rerun_cpp_sdk.zip

This patch release contains various bugfixes, improvements, and updated documentation.

🔎 Details

🌊 C++ API

• Fix building with arrow 20.0.0 #9966 (thanks @adamreeve!)
• Fix MSVC C++20 compilation issues #9951

🪳 Bug fixes

• Add draw order to video (-frame-reference), fix 2d objects sometimes being behind videos #9946
• Fix time series points querying extra points at start and end of time range (causing stuttering on playback in some scenes) #9963
• Increase max size of gRPC messages #10006
• Check TextEdit state before copying selection description #10063

🌁 Viewer improvements

• Use recording name for file name when saving a file #9982
• Improve error message for QueryError and DataLoaderError #9998

🚀 Performance improvements

• Series of build changes for web release to minimize generated wasm #9870

📚 Docs

• Remove remaining mentions of rr.connect #10016
• Update callbacks and custom_callbacks example docs to mention the other #10062
• Fix missing reference to Spatial3DView in Pinhole docs #9932 (thanks @hu-po!)
• Mention URL scheme in connect_grpc docs #10018

🤷‍ Other

• LeRobot: Add support for List datatype #9958

Rerun is an easy-to-use database and visualization toolbox for multimodal and temporal data.
Try it live at https://rerun.io/viewer.

• Python: pip install rerun-sdk
• Rust: cargo add rerun and cargo install rerun-cli --locked
• Online demo: https://rerun.io/viewer/version/0.23.2/
• C++ FetchContent: https://github.com/rerun-io/rerun/releases/download/0.23.2/rerun_cpp_sdk.zip

✨ Overview & highlights

• New CLI tool to migrate .rrd files
• Various bugfixes

.rrd migration tool

With 0.23, we made several breaking changes that resulted in older .rrd files not being able to load at all anymore.
To help smoothen the migration to 0.23, we're introducing a migrate command to the Rerun CLI:

rerun rrd migrate colmap.rrd arkit.rrd rgbd.rrd

The command will copy the contents into a .backup file, and then migrate the file.

Due to the incompatibility between .rrd files from 0.23 and those from earlier versions, this command likely
won't be able to migrate every recording perfectly. We expect the migration to work on files between 0.20 and 0.22,
simpler recordings may work as far back as 0.18.

We plan to use this command future .rrd migrations as a way to fulfill our N+1 compatibility guarantee:

• Viewers after 0.23 will always be able to load recordings from the previous version.
• Recordings from 0.23 and beyond may be migrated to the next version.

We currently have no plans for compatibility or migrations across multiple versions.

🪵 Log API

• Improve and mitigate warnings around data loss when flushing #9846

🐍 Python API

• Add ViewerClient to rerun.experimental #9828
• Improve set_time error handling for large Python integers #9839
• Properly resolve component selectors in dataset index creation and search APIs #9854
• Fix incorrectly advertised minimum supported pyarrow version (18.0.0 is required) #9878
• Fix incorrectly advertised numpy 1.x support (numpy2 is required now) #9880

🪳 Bug fixes

• Fix world grid not scaling correctly when camera is below the grid #9867
• Tensor view improvements #9831
• Fix size check for NV12 & YUY2 formats in C++ and Rust #9890

Rerun is an easy-to-use database and visualization toolbox for multimodal and temporal data.
Try it live at https://rerun.io/viewer.

• Python: pip install rerun-sdk
• Rust: cargo add rerun and cargo install rerun-cli --locked
• Online demo: https://rerun.io/viewer/version/0.23.0/
• C++ FetchContent: https://github.com/rerun-io/rerun/releases/download/0.23.0/rerun_cpp_sdk.zip

🪳 Bug fixes

• Use correct URL for RERUN_NOTEBOOK_ASSET #9800

🌊 C++ API

• C++: Emit warnings when using deprecated Rerun types #9801

🐍 Python API

• Direct API for setting blueprint on a notebook-embedded viewer #9804

🌁 Viewer improvements

• Fix doclinks to archetypes #9791

🧑‍🏫 Examples

• Add link to Gradio annotation example #9790 (thanks @pablovela5620!)

🖼 UI improvements

• Show image format (resolution etc) of image blobs #9792