Report Resolve's version, current page, database, open project and timeline.

Call this first in a session to see what state Resolve is in. Set ensure_running to launch Resolve if it is not already running.

List project and folder names in the current database folder.

Open an existing project by name. Unsaved changes to the current project are kept.

Create a new project and make it current. The name must be unique.

Save the current project.

Close the current project WITHOUT saving. Call project_save first to keep changes.

Delete a project from the current database folder. It must not be open.

Export a project to a .drp file.

Import a project from a .drp file.

Read one project setting, or all of them when setting is omitted.

Setting names are listed in the 'Looking up Project and Clip Properties' section of resolve://api/readme.

Write one project setting. Values are always passed as strings.

List the databases Resolve knows about, and which one is connected.

Switch database connection. This closes any open project.

db_type is 'Disk' or 'PostgreSQL'. ip_address applies to PostgreSQL only.

Navigate the database folder tree.

Pass folder_name to open a named subfolder, or go_to='root'/'parent'.

List every timeline in the current project, with handles.

Make a timeline current, by name or by 'timeline:' handle.

Return the page currently shown in Resolve.

Switch Resolve to a page.

One of: media, cut, edit, fusion, color, fairlight, deliver. Some operations only work while the matching page is open.

List the volumes shown in Resolve's Media Storage panel.

List subfolders and media files under an absolute path, as Resolve sees them.

Resolve consolidates image sequences into single entries here, which is why this differs from a plain directory listing.

Return the media pool bin tree.

root accepts a 'folder:' handle, 'root' (the default) or 'current'.

Return the bin that new imports will land in.

Create a bin under the given parent, or under the root bin by default.

Make a bin current, so subsequent imports land there.

Delete bins by handle. Their contents go with them.

Move bins into another bin.

List clips in a bin. Defaults to the root bin.

Search clips by substring of the clip name, recursing through sub-bins.

Read clip properties. Returns every property when name is omitted.

Write one clip property. Names are listed in resolve://api/readme.

Read clip metadata. Returns everything set when name is omitted.

Write one or more metadata keys on a clip.

Import media files or folders into the media pool.

Paths must be absolute and must exist. Pass bin_handle to import into a specific bin rather than the current one.

Move clips into another bin.

Delete clips from the media pool. This does not delete files from disk.

Set or clear a clip's colour. Omit color to clear it.

Read, add or clear clip flags. Pass clear='All' to remove every flag.

List markers on a media pool clip, sorted by frame.

Add a marker to a media pool clip at a source frame.

Delete a clip marker by frame, or every marker of a colour ('All' for all).

Link a proxy media file to a clip. proxy_path must be absolute.

Unlink any proxy media from a clip.

Replace the media behind a clip, keeping its place in timelines.

Relink offline clips by pointing them at a folder to search.

Take clips offline without removing them from the pool.

Create a timeline, empty or populated from media pool clips.

Pass clip handles from media_import or clip_list to build it in one call. The new timeline becomes current.

Describe a timeline: frame range, timecode and track counts.

Duplicate a timeline.

Delete timelines from the media pool.

Rename a timeline. Names must be unique within the project.

Read timeline settings. Returns all of them when setting is omitted.

Write one timeline setting.

Append media pool clips to the end of the current timeline.

clip_ranges optionally trims each clip. One dict per clip, with any of startFrame, endFrame, recordFrame, trackIndex, mediaType (1 video, 2 audio).

List the clips on one track of the current timeline. Indices are 1-based.

List every clip on every track of the current timeline.

Delete clips from the current timeline. ripple closes the gap left behind.

Enable or disable a timeline clip.

Rename a timeline clip.

Turn timeline clips into a compound clip.

Turn timeline clips into a Fusion clip.

Add a track. audio_type applies to audio tracks: mono, stereo, 5.1, 7.1, adaptive1-36.

Delete a track by 1-based index.

List tracks of a type with their names, enabled state and lock state.

Rename a track.

Enable or disable a track.

Lock or unlock a track. Locked tracks reject edits, silently.

List timeline markers, sorted by frame.

Add a marker to the current timeline.

frame is an offset from the timeline start, not a timecode. Colours include Blue, Cyan, Green, Yellow, Red, Pink, Purple, Fuchsia, Rose, Lavender, Sky, Mint, Lemon, Sand, Cocoa, Cream.

Delete a timeline marker by frame, or all markers of a colour ('All' for every one).

Return the playhead timecode of the current timeline.

Move the playhead. Format HH:MM:SS:FF. Works on Cut, Edit, Color, Fairlight, Deliver.

Read, set or clear the timeline in/out marks.

Called with no frames, it clears them. mark_type is video, audio or all.

Insert a title at the playhead. fusion=True inserts a Fusion title instead.

Insert a generator at the playhead. kind is standard, fusion or ofx.

Insert an empty Fusion composition at the playhead.

Create a timeline from an AAF, EDL, XML, FCPXML, DRT, ADL or OTIO file.

Export a timeline.

export_type is one of: aaf, drt, edl, fcp7xml, fcpxml, otio, hdr10, txt, dolby.

Detect scene cuts and add edits along the timeline.

Apply a LUT to a node on a timeline clip.

node_index is 1-based (it changed from 0-based in Resolve 16.2). The LUT must already be discovered by Resolve — call lut_refresh after adding new LUT files.

Read the LUT applied to a node.

Rescan the LUT folders. Call after adding LUT files on disk.

Apply ASC CDL values to a node. Each of slope/offset/power is three numbers.

Copy the full grade from one timeline clip to others.

Describe a clip's node graph: node count, labels and LUTs.

List colour versions on a clip.

Add a colour version to a clip.

Make a colour version current on a clip.

Delete a colour version from a clip.

Grab a gallery still from the current clip, or from every clip on the timeline.

frame_source applies to all_clips: 1 for first frame, 2 for middle frame. Requires the Color page.

List stills in the current gallery album.

Export gallery stills to a folder.

Delete gallery stills.

List gallery still albums and PowerGrade albums.

Export the current frame as a still image. The extension sets the format.

List colour groups in the current project.

Create a colour group. The name must be unique.

List render formats available in this project, as name -> file extension.

List codecs for a format. Pass the extension, e.g. 'mov', not 'QuickTime'.

List resolutions valid for a format and codec, or all of them when omitted.

Set the render format and codec. Use the codec's short name from render_codecs.