Replay a recording
Play back an MCAP file or a ROS 2 bag and scrub through it. Use it to review a run or build tests on real data.
Before you start
- The recording on this computer: a
.mcapfile, a folder of them, or a ROS 2 bag folder. - To install a connector, sign this computer in.
Steps
- Open Inputs and press Add input.
- Search for
mcap, orros2for a ROS 2 bag. If it shows Install, select it to install it. - Fill the fields for your connector:
Connector
| Field | Set to |
|---|---|
| Recording | /data/run_42.mcap, or a folder of them |
| Time | As recorded |
| Speed | 1 plays at recorded speed; 0 loads as fast as the disk allows |
| Loop | leave off |
| Field | Set to |
|---|---|
| Source | Bag file |
| Bag | /data/walk_2026-09-10, or one .mcap / .db3 file of it |
| Time | As recorded |
| Speed | 1 plays at recorded speed; 0 loads as fast as the disk allows |
| Loop | leave off |
- In Topics, tick the topics to bring in. The table shows what each one becomes.
- Press Add & start.
- Open Replay. In the time control, choose All history or the day of the recording.
- Press /, type part of a topic name, and tick its channels.
- Drag the playhead along the scrubber, or press Space to play.
Check it worked
On Inputs the row counts samples, then shows finished. On Replay the
scrubber shows bands where there is data, and the charts move as you scrub.
Note
With Loop on, the file replays over and over, timed as if it were arriving now. It shows on Live, not on Replay.
ReplayThe scrubber, channel search and keyboard keysFiles & recordingsEvery recording type you can addVerify that your data is arrivingRead an input's row when nothing shows
Updated