Return the name of the currently active Resolve page.

Possible values: "media", "cut", "edit", "fusion", "color", "fairlight", "deliver", or "" if Resolve cannot determine the page.

Switch Resolve to a different workspace page.

Return the current playhead timecode (e.g. "01:00:05:12").

Requires an open project with at least one timeline.

Move the playhead to a specific timecode position.

Return info about the timeline item under the playhead, or None.

Returns a dict with keys: name, start, end, duration. Returns None if no item is under the playhead or no timeline is open.

Return the DaVinci Resolve version as a dotted string (e.g. "19.1.2").

The underlying API may return a list of version components or a string; this tool always returns a single joined string.

Return the Resolve product name.

Typically "DaVinci Resolve" (free) or "DaVinci Resolve Studio" (paid).

List all project names in the current database folder.

Returns an alphabetically-ordered list of project name strings.

Create a new project and open it immediately.

Open an existing project by name.

Save the current project.

Returns: True if the save succeeded.

Close the current project (saves automatically before closing).

Returns: True if the project was closed successfully.

Delete a project by name. The project must NOT be currently open.

Return basic info about the currently open project.

Returns: A dict with keys: name (str), timeline_count (int).

Read a single project setting by its key.

Write a project setting.

Import a .drp project file into the current database folder.

Export the current project to a .drp file.

List sub-folders in the current database folder.

Returns: A list of folder name strings.

Navigate into a sub-folder within the project database.

Create a new folder in the current database folder.

Delete a folder from the current database folder.

The folder must be empty (no projects inside).

Navigate to the root of the project database.

Returns: True if navigation to root succeeded.

Navigate up one level in the project database folder hierarchy.

Returns: True if navigation succeeded. False if already at root.

Return info about the current project database.

Returns: A dict with database info (DbType, DbName, IpAddress if remote).

Archive a project to a .dra file.

The project must NOT be currently open.

Restore a project from a .dra archive file.

List all available project databases.

Returns: A list of dicts, each with keys like "DbType", "DbName", and optionally "IpAddress" for remote databases.

List all mounted media storage volumes visible to DaVinci Resolve.

Returns the volume paths (e.g. '/' on macOS, 'C:' on Windows, or NAS mount points) that appear in the Media page's storage panel.

List subfolders inside a media storage path.

List media files in a storage folder.

Import files from media storage into the current project's media pool.

Get the name of the Media Pool's root folder.

Every project has exactly one root folder (usually named 'Master').

Get the name of the currently selected Media Pool folder.

Navigate into a Media Pool folder by name.

Create a new subfolder inside the current Media Pool folder.

Delete Media Pool subfolders by name.

List clips in the current Media Pool folder with pagination.

List the names of all subfolders in the current Media Pool folder.

Import media files from disk into the current Media Pool folder.

Create a new empty timeline in the current Media Pool folder.

Create a new timeline populated with specific clips from the current folder.

Delete clips from the current Media Pool folder by name.

Move clips from the current folder to a different Media Pool folder.

Relink offline clips to media files in a new folder.

Export metadata of all clips in the current folder to a CSV file.

Return the display name of a media-pool clip.

Rename a media-pool clip.

Return all metadata fields for a clip as key-value pairs.

Set a single metadata field on a clip.

Return all clip properties (Clip Name, Duration, FPS, etc.).

Set a single property on a clip.

Return the label color assigned to a clip (e.g. "Orange", "Blue").

Set the label color on a clip.

Remove the label color from a clip, resetting it to the default.

Add a marker to a media-pool clip at a given frame.

Return all markers on a clip. Keys are frame IDs (as strings).

Delete the marker at a specific frame on a clip.

Add a flag of the given color to a clip.

Return all flag colors currently set on a clip.

Remove a specific flag color from a clip.

Start audio transcription for a clip.

Requires DaVinci Resolve 19+ with speech-to-text support enabled.

Get the transcript text for a clip.

Clear the transcript text from a clip.

Link an external proxy media file to a clip.

Replace a clip's media file with a new file.

Remove proxy media link from a clip.

Return info about the current timeline, or None if no timeline is open.

Returns a dict with keys: name, start_frame, end_frame, video_tracks, audio_tracks, start_timecode.

Set the current timeline by name.

Return the number of timelines in the current project.

Return info about a timeline at the given 1-based index.

Return the name of the current timeline.

Raises an error if no timeline is open.

Rename the current timeline.

Return the start frame number of the current timeline.

Return the end frame number of the current timeline.

Return the number of tracks of the given type in the current timeline.

Add one or more tracks to the current timeline.

Delete a track from the current timeline.

Return the name of a specific track in the current timeline.

Rename a track in the current timeline.

Enable or disable a track in the current timeline.

Lock or unlock a track in the current timeline.

List timeline items on a specific track with pagination.

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

Searches the media pool's current folder for clips matching the given names, then appends them in order.

Delete timeline items by name from a specific track.

Duplicate the current timeline.

Returns: The name of the newly created timeline, or None if duplication failed.

Add a marker to the current timeline at a specific frame.

Return all markers on the current timeline.

Returns: A dict mapping frame numbers (as string keys) to marker info dicts. Each marker dict contains: color, duration, note, name, customData. Returns an empty dict if no markers exist or no timeline is open.

Delete a marker at a specific frame on the current timeline.

Export the current timeline to a file (AAF, EDL, FCPXML, etc.).

Create a compound clip from timeline items on a specific track.

A compound clip merges multiple timeline items into one editable unit.

Create a Fusion clip from timeline items on a specific track.

A Fusion clip wraps selected items into a single Fusion composition that can be opened and edited in the Fusion page.

Detect scene cuts in the current timeline.

Analyzes the video content and returns frame numbers where scene transitions were detected. Requires DaVinci Resolve 18.5 or later.

Returns: A list of frame numbers where cuts were detected.

Auto-generate subtitles from audio in the current timeline.

Uses Resolve's built-in speech-to-text to create subtitle track items. Requires DaVinci Resolve 18.5 or later.

Returns: True if subtitles were generated successfully.

Read a timeline-specific setting by key.

Write a timeline-specific setting.

Return the display name of a timeline item.

Return the duration of a timeline item in frames.

Return the start frame, end frame, and duration of a timeline item.

Return all properties of a timeline item as key-value pairs.