Rerun Files

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 -U 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.33.0/rerun_cpp_sdk.zip

---

🧳 Migration guide: https://rerun.io/docs/reference/migration/migration-0-33

✨ Overview & highlights

After our large 0.32.0 release, this one is more focused but still has some great new things in store for you!

Headless viewer

This release comes with a new headless mode for the viewer! Together with smaller improvements to the screenshot API, this can be an invaluable tool for automation and LLM usage.

:::python
import rerun.blueprint as rrb
from rerun.experimental import ViewerClient

# Spawn a headless viewer; the client owns its lifetime.
# ⚠️ you need a graphics driver to run this (software rasterizers like lavapipe are fine too!).
with ViewerClient(spawn=True, headless=True) as viewer:
    rec = rr.RecordingStream("rerun_example_screenshot")
    rec.connect_grpc(url=viewer.url)

    view = rrb.Spatial3DView(name="my blue 3D", background=[100, 149, 237])
    rec.send_blueprint(view)

    # Screenshot only the view we created earlier.
    viewer.save_screenshot("my_view.png", view_id=view.id)

    # Disconnect the RecordingStream before the headless viewer shuts down.
    rec.disconnect()

We're planning more features for ViewerClient Python object, including an MCP server allowing agents to fully instrument the Viewer. Stay tuned!

Push-down filtering on chunk processing

This release brings a significant optimization to pipelines in the shape of:

:::python
from rerun.experimental import RrdReader

lazy_store = RrdReader(...).store()
stream = lazy_store.stream().filter(...)
# more stream operations

The filter is now pushed down to RrdReader, which will selectively load the matching chunks only. This massively accelerates targeted data extraction from large RRDs (e.g. extract a joint data from a RRD that also contains multiple video streams).

Improvements on experimental state timeline view

We're continue to perfect the state timeline view, and this release brings this lot of improvements:

https://github.com/user-attachments/assets/b7549593-363f-4e13-ab9b-184d6434fc19

• Support for numbers and boolean components, not just strings.
• Drag a component right from the streams tree into a state timeline.
• Highlight the time range of a state by hovering it.
• Clear state by logging an empty string or a Clear message: the timeline shows a gap until the next state value.

Improvements on experimental dataset review

Amongst other improvements, we made the play behavior much nicer for our experimental dataset review and table blueprint feature:

https://github.com/user-attachments/assets/4543af53-52ca-4488-90b0-8c365f9fb89b

Nicer native Viewer title bars on Windows & some Linux desktops

On MacOS we used to have a compact title bar for a very long time. Now the same feature comes finally to Windows and some Linux desktops.

Before:

<picture> </picture>

✨ After ✨:

<picture> </picture>

If you experience any issues with this you can turn it off in the settings menu.

⚠️ Breaking changes

The Python optional-dependency extra for catalog/query API tools has been renamed to catalog.

Before	After
pip install rerun-sdk[dataplatform]	pip install rerun-sdk[catalog]
pip install rerun-sdk[datafusion]	pip install rerun-sdk[catalog]

🧳 Migration guide: https://rerun.io/docs/reference/migration/migration-0-33

🔎 Details

🪵 Log API

• Fix problem of intermixing different store messages in one rrd bee551f

🐍 Python API

• Add trim_metadata_keys argument to Chunk.format 2d6cd8d
• Allow #when anchors without #time_selection 1c242c8
• Optional Hub ingestion of customer SDK traces 5a362a3
• Remove segment id validation with dataset.reader(..., using_index_value=...) 7846d38
• Dedup video stream samples in video decoder d341ba4
• Pushdown LazyChunkStore.filter() to LazyStore 99a2149
• Add headless viewer mode b050087
• rerun-sdk[datafusion] and rerun-sdk[dataplatform] extras are now rerun-sdk[catalog] fcb5b13

🦀 Rust API

• Increase the re_sdk viewer spawn timeout to 4s 230cde6
• Optional Hub ingestion of customer SDK traces 5a362a3
• Add headless viewer mode b050087

🪳 Bug fixes

• Create spatial topology from schema instead of from chunk data (fixing to sometimes never pull data) 3fffd8b
• Respect play state from blueprint with Catalog Server 35613c9
• Fix orbital zoom clamp panic on tiny scenes 6f1bcde
• Fix notification id collision a453f9a
• Fix previews repeatedly opening log sources 4e03a27
• Fix video issues after GC at start of recording 9670f20
• Dataloader: skip predicate keyframes c8b963f
• Default Safari to WebGL — Safari 26.4 broke 3D under WebGPU #12789
• Fix occasional Viewer hangs on some Wayland systems 1f7680c
• Fix handling of png encoded depth images on the web bcfbd22
• MCAP: resolve field type ambiguities in message schema reflection 0ce185b
• Implement unclamped SetTime and fix #when anchors d33a6ab
• Fix encoded rvl images 717b40d
• MCAP: fix sensor_msgs/PointCloud2 offsets for extra fields 20fe293
• Fix AV1 OBU walker cursor drift c61b60b
• Clear log support for state timeline 639c5e6
• Take grpc server into account when purging viewer memory 09b0192

🌁 Viewer improvements

• Emit VideoStream::is_keyframe in rrd optimize ab74f37
• Opening a url with a timestamp anchor now always pauses the recording 24827ea
• Add a copy button to image previews 8e5e5ad
• Components from timeline panel can be dropped to State timeline e68e001
• Show loading indicator for dataset previews 9e811e5
• State timeline accepts numbers and booleans de849aa
• Compact title bar on Linux & Windows 475fc45
• Surface errors when loading a URI e3aabd7
• Add "Show/Hide in all views" entity context menu actions aa49fc4 (thanks @ollema!)
• Individual controllable time playing for previews 4b17956
• Vertical scroll support for state timelines 6dc3e49
• Fixes last state in timeline extending to infinity a13dc44
• Hovered state highlights time range in time-based views 5258852
• Make webdecoder more robust against spurious decoding problems fb2e5d1

🚀 Performance improvements

• Faster queries: do not split or compact chunks 0cb8ffb
• re_server: refresh schema cache after add_layer 2e736c4
• Separate is keyframe chunk 85fe857
• Speed up queries over single columns 5bc08c6
• Enable SIMD on wasm 3bcaca0
• Making dataloader keyframe aware 203d7ce
• Speedup for points & line rendering on Apple Silicon in some situations b8b0ced
• Cache RGB8 image histograms #12800 (thanks @waamm!)

🧑‍🏫 Examples

• Add example for preprocessing a robot recording via chunk API 396a512

📚 Docs

• Adding overview to Getting Started 473abad
• Moving install and setup from overview to getting started on resources page f1de7a4
• Make more reference material available in the side bar ba868d9
• Simplifying docs guide 0ca2c5f
• Add migration note for legacy ROS 1 data de6a430
• Fix custom-data doc page claiming you can't visualize custom data, instead redirect to pages that explain how 7bad539

🖼 UI improvements

• Respect Wayland compositor preferences for client/server-side decorations 0c00f57
• Add a nicer About-menu 6645dbe
• Reset states timeline view via double-click 36cf84d

🧢 MCAP

• Keep MCAP channels without schema as raw data 7b87ed0
• MCAP: Add lens for ROS 2 geometry_msgs/PoseStamped be7012c
• Move std_msgs/String to lens 06fef1c
• Move rcl_interfaces/msg/Log to lens 325b28f

📈 Analytics

• Datafusion metrics fdbb66f

🧑‍💻 Dev-experience

• Include trace-id in error message on failed registration bab7682