Timeline overview
The timeline is divided into several key areas:- Ruler - Shows time markers and allows you to navigate through your project
- Bookmarks row - Add markers and notes at specific points in your timeline
- Track area - Contains all your video, audio, text, and sticker tracks
- Track labels - Shows track controls (mute, hide, track type icons)
- Playhead - Indicates the current playback position
Playback controls
Play and pause
Control playback using the play/pause button or keyboard shortcuts:- Press
SpaceorKto play/pause - Playback automatically stops when reaching the end of your timeline
- If the playhead is at the end, pressing play will reset to the start
apps/web/src/core/managers/playback-manager.ts:16-42
Seeking and navigation
Frame-by-frame navigation
Frame-by-frame navigation
Jump navigation
Jump navigation
Seek shortcuts
Seek shortcuts
J- Seek backward 1 secondL- Seek forward 1 second
Timeline scrubbing
Click anywhere on the ruler to instantly jump to that point in time. You can also click and drag the playhead for precise scrubbing. Source:apps/web/src/hooks/timeline/use-timeline-seek.ts
Zoom and scroll
Zooming
Adjust the timeline zoom level to see more or less detail:- Use the zoom slider in the timeline toolbar
- Click the zoom in (+) or zoom out (-) buttons
- Scroll with mouse wheel while holding modifier key
apps/web/src/constants/timeline-constants.ts
Scrolling
- Horizontal scroll - Use the scrollbar or Shift + mouse wheel
- Vertical scroll - Mouse wheel scrolls through tracks
- Auto-scroll - When dragging elements near edges, the timeline auto-scrolls
Timeline interactions
Selecting elements
Single selection
Click on any element in the timeline to select it. The selected element will be highlighted.
Multiple selection
- Click and drag to create a selection box around multiple elements
- Hold
Ctrl/Cmdand click individual elements to add to selection - Press
Ctrl/Cmd + Ato select all elements
apps/web/src/core/managers/selection-manager.ts
Moving elements
Drag any element left or right to adjust its position in time:- Click and hold on an element
- Drag horizontally to move it along the timeline
- Drag vertically to move it to a different track
- Release to place the element at the new position
With snapping enabled (magnet icon in toolbar), elements automatically align to the playhead, other elements, and time markers for precise positioning.
apps/web/src/hooks/timeline/element/use-element-interaction.ts
Trimming elements
Adjust the in and out points of video, audio, and image elements:- Hover over the left or right edge of an element
- The cursor changes to indicate resize mode
- Click and drag to trim from the start (left edge) or end (right edge)
- The element duration updates in the properties panel
apps/web/src/core/managers/timeline-manager.ts:53-93
Resizing elements
For text and sticker elements, you can adjust their duration:- Hover over the right edge of the element
- Click and drag to extend or shorten the duration
- Release to apply the new duration
apps/web/src/core/managers/timeline-manager.ts:72-93
Editing operations
Splitting elements
OpenCut provides three split operations:Split
Cuts element(s) at the playhead position, keeping both sides.Shortcut:
SSplit left
Cuts and removes everything before the playhead.Shortcut:
QSplit right
Cuts and removes everything after the playhead.Shortcut:
Wapps/web/src/lib/actions/definitions.ts:73-87
Copy and paste
Source:
apps/web/src/lib/actions/definitions.ts:93-102
Duplicate elements
Quickly create a copy of selected elements:- Press
Ctrl/Cmd + Dto duplicate - The duplicate appears immediately after the original element
- Works with multiple selected elements
apps/web/src/core/managers/timeline-manager.ts:274-282
Delete elements
Remove unwanted elements from your timeline:- Select elements and press
BackspaceorDelete - Right-click an element and choose “Delete” from the context menu
- Click the delete button in the timeline toolbar
apps/web/src/lib/actions/definitions.ts:88-92
Advanced features
Snapping
Toggle snapping on/off using the magnet icon in the toolbar or pressN.
When enabled, elements snap to:
- The playhead position
- Start and end points of other elements
- Timeline start (0:00)
apps/web/src/lib/actions/definitions.ts:103-107
Ripple editing
Enable ripple editing using the link icon in the timeline toolbar. When active, editing operations automatically shift subsequent elements to maintain the timeline flow without gaps. Source:apps/web/src/components/editor/panels/timeline/timeline-toolbar.tsx:196-216
Bookmarks
Add bookmarks to mark important points in your timeline:- Position the playhead at the desired time
- Press the bookmark button or use the keyboard shortcut
- Toggle bookmark on/off at the current playhead position
- Bookmarks appear in the bookmarks row above the tracks
- Drag bookmarks to reposition them
apps/web/src/lib/actions/definitions.ts:126-129
Undo and redo
All editing operations support unlimited undo/redo:Ctrl/Cmd + Z- Undo last actionCtrl/Cmd + Shift + ZorCtrl/Cmd + Y- Redo
apps/web/src/lib/actions/definitions.ts:130-139