Appearance
Track timeline
The track timeline is the main interface for managing annotations across frames in a sequence. It's always visible at the bottom of the editor.
Overview
The timeline displays your annotations as horizontal rows (tracks) across time (frames), with each track showing:
- Track ID and category
- Where the object is present (colored bars)
- Keyframe locations (diamond icons)
- Track attributes (when selected)
Timeline views
The timeline adapts its display based on your current selection:
Tracks view
Access: No track selected + View dropdown = "Tracks"
Shows all tracks in your sequence with:
- One row per track
- Track ID and category name on the left
- Colored bars showing track visibility
- Keyframes marked with white diamonds (◆)
- Remove-keyframes marked with white crosses (×)
Use this view to:
- Get an overview of all objects in the sequence
- Compare timing between different tracks
- Select a track to work on
Scene attributes view
Access: No track selected + View dropdown = "Scene attributes"
Shows scene-level attributes with:
- One row per scene attribute
- Attribute name on the left
- Editable cells for each frame
Use this view to:
- Label environmental conditions (weather, lighting, etc.)
- Add sequence-level metadata (recording location, camera settings, etc.)
Single track view
Access: Select any track in the viewer (automatic)
Shows only the selected track with:
- The track row at the top
- Track attribute rows below (if attributes exist)
- View dropdown is disabled
Use this view to:
- Focus on labeling a specific object
- Edit track-specific attributes
- Work with keyframes for that track
The timeline automatically switches to single track view when you select an object. Deselect the object (click in empty space) to return to the previous view. The track list is synchronized with the sidebar panel.
Navigate between frames
Navigation controls
The timeline header provides several ways to move between frames:
Navigation buttons:
: Previous frame
: Next frame
: Jump to last frame
: Jump to first frame
Direct selection:
- Click on any frame column to jump directly to it
Keyboard shortcuts:
- Arrow keys: Move frame-by-frame
- Shift + Arrow keys: Jump multiple frames
Visual feedback:
- Active frame: Highlighted vertical column
- Hovered frame: Gray highlight when you hover over a frame
Create tracks
When you add a new object in the viewer:
- A track is automatically created with a unique track ID
- A new row appears in the timeline (Tracks view)
- A keyframe is created at the current frame
- The track bar displays the track's visibility range using the same color as the object in the viewer
Track IDs increment sequentially, starting from the highest existing track ID.
Manage tracks
Right-click on any track row to open the context menu with these options:
Update track ID
Change the track's ID across all frames. Useful for:
- Correcting incorrectly assigned IDs
- Aligning with external tracking data
See Use track IDs - Update a track ID for details.
Merge with track
Combine two tracks into one. Useful for:
- Fixing tracking errors where one object was assigned multiple IDs
- Correcting splits that shouldn't have happened
Merging is only possible when both tracks have no overlapping keyframes.
See Use track IDs - Merge tracks for details.
Hide and lock tracks
Click the eye icon on a track row to hide it — the track remains saved but invisible in the viewer.
Click the lock icon on a track row (or via the right-click context menu) to lock it. A locked track cannot be moved, resized, edited, or have its category changed. The cursor changes to a lock icon when hovering over a locked object in the viewer.
Use Lock all / Unlock all in the global timeline menu [⋮] to lock or unlock all tracks at once.
Locking is local and temporary — not saved to the server, resets on reload.
Shortcut: Shift + R — toggle lock on the active track.
Remove track
Delete the entire track and all its annotations. This action:
- Removes all keyframes
- Deletes all attribute values
- Can be undone via undo history
When a track is removed, the highest track ID becomes available for new objects.
Split track
Divide a track into two separate tracks at the current frame. Useful for:
- Separating objects that were tracked as one
- Handling scenarios where one object becomes two
Splitting is only possible if there are keyframes before the current frame.
Split track is only available in single-sensor sequences.
See Use track IDs - Split a track for details.
Work with keyframes
View keyframes
Keyframes appear as white diamond icons (◆) on the track bar. Each diamond marks a frame where you've defined the object's state.
Remove-keyframes appear as white cross icons (×) on blank spaces, marking frames where you've explicitly removed the object.
Keyframe operations
The timeline supports several keyframe operations:
Select keyframes:
- Click on a keyframe to select it
- The viewer jumps to that frame automatically
Move keyframes:
- Drag keyframe diamonds to different frames
- Interpolation recalculates automatically
- Movement is constrained to segments where the object exists (within the colored bar)
Delete keyframes:
- Select a keyframe and press
Backspace - The keyframe is removed and interpolation adjusts
Copy and paste keyframes:
- Copy a keyframe's state and paste it to another frame
- Useful for duplicating complex object states
Keyframe movement is constrained to preserve data integrity. You can only move keyframes within the track's visibility range.
For detailed keyframe operations, see Use keyframe interpolation.
Edit attributes in timeline
The timeline allows direct editing of attribute values without leaving the labeling interface.
Track attributes
When to see them: Select a track
Track attribute rows appear below the track row, showing:
- Attribute name on the left
- One cell per frame (or one cell for sequence-level attributes)
- Cell type matches the attribute type (text, number, dropdown, checkbox, etc.)
How to edit:
- Click on any cell
- Enter or select the value
- The value is saved automatically
Synced across frames:
- If enabled: Editing one cell updates all frames
- If disabled: Each frame can have a different value
Link attributes
When to see them: Select a track in a sequence dataset with object linking enabled and link attributes configured.
The single track view includes a section for each outgoing link below the track's own attributes. Each section identifies the linked track by its ID and category, with a right arrow for an outgoing link and attribute rows underneath. The available attributes are defined by the source object's category.
To edit a link attribute:
- Click a value bar in the attribute row to select its frame range. Click the selected bar again to select a single frame. For frame-level attributes, you can also use
Ctrl+ click (Cmd+ click on macOS) to select a single frame, thenShift+ click to extend the range across adjacent bars. - Right-click within the selected range to open the attribute editor.
- Enter or select the value. The change applies to the selected range.
Attributes configured as Synced across frames have one value for the entire sequence. Link attribute values are shared across sensors in multi-sensor datasets.
To include incoming links, enable Show backlinks in the three-dot menu of the sidebar's Links section. These sections use a left arrow and show the attributes defined by the incoming link's source category. Hover over a link section's header to highlight the related object, or click the header to select its track.
Scene attributes
When to see them: Deselect all tracks + View dropdown = "Scene attributes"
Scene attribute rows appear, showing:
- Attribute name on the left
- One cell per frame (frame-level) or one cell total (sequence-level)
How to edit: Same as track attributes — click and edit.
For configuring attributes (synced vs not synced, frame-level vs sequence-level), see Configure the label editor.
Timeline layout
Sticky elements
As you scroll through the timeline:
- Name column stays visible on the left, so you always see track/attribute names
- Navigation header stays visible at the top, so controls are always accessible
Scrolling
- Horizontal scrolling: View frames beyond the visible area (useful for long sequences)
- Vertical scrolling: View tracks beyond the visible area (only in all tracks view)
Active frame indicator
The active frame is marked with a highlighted vertical column spanning the entire timeline height. This makes it easy to see your current position, especially when scrolling.