Timeline (write)
timeline_writeModify DaVinci Resolve timeline state by adding markers, tracks, and clips; renaming, importing/exporting, and setting timecodes or track states. Changes are read back to verify they took effect.
Instructions
Change timeline state; may overwrite current values. Every change is read back from Resolve (receipt.verified=false means it did not take). op.action (params; * = required):
add_marker(frame*, color, name, note, duration, custom_data): Add a marker at a frame offset of a timeline.
add_markers(markers*): Add several markers in one call; frames already occupied are skipped.
add_track(type*, sub_type): Add a video, audio or subtitle track (audio accepts a sub type).
append_clips(clips*): Append Media Pool clips to a timeline (end frames exclusive, record offsets relative).
auto_align_clips(items*, sync_using, use_track): Align timeline items by timecode or waveform (Resolve 21.1+).
clear_mark_in_out(type): Clear mark in/out.
convert_to_stereo(): Convert the timeline to stereoscopic 3D.
create_compound_clip(items*, name, start_timecode): Create a compound clip from timeline items.
create_fusion_clip(items*): Create a Fusion clip from timeline items.
create_timeline(name*): Create an empty timeline in the current Media Pool folder.
create_timeline_from_clips(name*, clips*): Create a timeline from Media Pool clips (optional source in/out per clip).
duplicate_timeline(name*): Duplicate a timeline under a new name; the current timeline is left unchanged.
export_timeline(path*, format*, subtype): Export a timeline (EDL, XML, AAF, DRT, OTIO, ...) to a file.
import_into_timeline(path*, insert_additional_tracks, insert_with_offset, source_clips_path, link_to_source_camera_files, use_sizing_info): Import items from an AAF file into an existing timeline.
import_timeline(path*, timeline_name, import_source_clips, source_clips_path, interlace_processing): Create a timeline from an EDL/XML/AAF/DRT/OTIO file.
insert_generated(kind*, name): Insert a generator, title, OFX or Fusion generator/title/comp at the playhead.
rename_timeline(name*): Rename a timeline (the new name must be unique).
rename_track(track*, name*): Rename a track.
set_clips_linked(items*, linked*): Link or unlink timeline items.
set_current_timecode(timecode*): Move the playhead to a timecode (from the Edit page when Resolve is on Media).
set_current_timeline(): Make a timeline the current one.
set_mark_in_out(mark_in*, mark_out*, type): Set mark in/out (frames relative to timeline start).
set_output_blanking(top, bottom, left, right): Set the timeline output blanking in pixels (Resolve 21.1+).
set_settings(settings*): Set timeline settings (verified key by key; some keys are silently refused).
set_start_timecode(timecode*): Set the timeline start timecode.
set_track_enabled(track*, enabled*): Enable or disable a track.
set_track_locked(track*, locked*): Lock or unlock a track (a locked V1 makes Insert* calls fail).
update_marker_custom_data(frame*, custom_data*): Replace the custom data of the marker at a frame offset. Shortcuts (prefer them for whole tasks):
workflow_write.build_vertical_reel: Build a vertical timeline from clips, add subtitles and optionally render it. One call instead of create_timeline, create_timeline_from_clips, set_settings.
workflow_write.conform_from_edl: Import media + EDL as a timeline, fix offline events via Start TC, report linkage. One call instead of import_timeline, set_start_timecode. Calls known in advance (a sequence, the same change on several items): ONE batch_run.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | {action, ...params}. Parameters per action: see the description or this server's describe_action tool. | |
| dry_run | No | true: return the planned effect, change nothing. | |
| snapshot | No | true: back up the timeline/project first; omitted: server policy. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | ||
| plan | No | ||
| status | Yes | ||
| receipt | No |