Browse docs
Write a schema
Start with one source and inspect its auto-layout. Add panels when you know which cameras or signals to compare. These types belong to the existing schema API:
timeline.source selects the source that provides the shared clock; it defaults
to the first source. panels is optional. Pass a parsed object to
DatasetPreview; parse YAML in the application when using a configuration file.
sources — an adapter + storage
Set adapter for the format, storage for access, and format options such as
episode alongside them:
See Adapters for format options and Storage for public and application-provided drivers.
panels — views over fields
Bind cameras with fields, styled numeric traces with series, and intervals
with tracks:
A dotted string is one complete feature name. Use [feature, dimension] for a
named or numbered column; * matches feature or dimension names, as in
[observation.effort, "left_*"].
The views reference describes each panel's layout and presentation options.
End-to-end: a folder of clips → one videoStack
A filesystem source discovers clips through storage listing. With the HTTP
driver, provide an index.json in the folder:
Code FilesystemFolderSpec.tsx
This source has no dataset timeline. The video stack uses the longest discovered clip duration for scrubbing.
End-to-end: a LeRobot episode → multi-panel
Here the episode supplies a shared timeline. The camera grid, task intervals and joint comparison all use that time.
Code LerobotEpisodeSpec.tsx
End-to-end: hand skeletons via overlays
An overlay references an annotation file in the same source. Its format
describes how to read that file. This example uses hand detections over video and
subtask intervals in both the video and timeline.
Code HandOverlaySchemaSpec.tsx
handJoints expects the documented hand-detection shape, subtasks expects
labeled subtask intervals, and raw expects MediaOverlay JSON. See the
overlay data formats. Set on to a
video field reference to target a tile; omit it to apply the layer across tiles.
Omit panels → auto-layout
Omit panels to inspect an unfamiliar source before choosing bindings:
Code AutoLayoutSpec.tsx
Auto-layout groups fields by kind. The layout rules describe camera stacks, frame sequences, timelines and charts.