Get information about the current DaVinci Resolve project.

Returns project name, settings (frame rate, resolution), timeline count, current page, and version info.

Switch to a specific page in DaVinci Resolve.

Parameters:

• page: One of "media", "cut", "edit", "fusion", "color", "fairlight", "deliver"

Get the currently active page in DaVinci Resolve.

Get the folder/clip structure of the media pool.

Parameters:

• max_depth: Maximum folder recursion depth (default: 3)

• max_clips: Maximum clips to list per folder (default: 50)

Import media files into the current media pool folder.

Parameters:

• file_paths: List of absolute file paths to import

Create a new empty timeline in the current project.

Parameters:

• name: Name for the new timeline

Get detailed information about the current timeline.

List all clips/items on a specific track of the current timeline.

Parameters:

• track_type: "video", "audio", or "subtitle" (default: "video")

• track_index: 1-based track index (default: 1)

Append media pool clips to the current timeline by name.

Parameters:

• clip_names: List of clip names to append (must exist in the current media pool folder)

Add a marker to the current timeline.

Parameters:

• frame_id: Frame position for the marker

• color: Marker color ("Red", "Orange", "Yellow", "Green", "Cyan", "Blue", "Purple", "Pink", "Fuchsia", "Rose", "Lavender", "Sky", "Mint", "Lemon", "Sand", "Cocoa", "Cream")

• name: Marker name

• note: Optional note text

• duration: Marker duration in frames (default: 1)

• custom_data: Optional custom data string

Get all markers on the current timeline.

Move the playhead to a specific timecode.

Parameters:

• timecode: Timecode string in "HH:MM:SS:FF" format

Get the current playhead timecode.

Get all properties of a specific timeline item.

Parameters:

• track_type: "video", "audio", or "subtitle" (default: "video")

• track_index: 1-based track index (default: 1)

• item_index: 0-based index of the item in the track (default: 0)

Set a property on a specific timeline item.

Parameters:

• property_key: Property name (e.g. "Pan", "Tilt", "ZoomX", "ZoomY", "Opacity", "CropLeft", "CropRight", "CropTop", "CropBottom", "RotationAngle", "FlipX", "FlipY", "CompositeMode", "RetimeProcess", "Scaling", etc.)

• property_value: Value to set (will be auto-converted to appropriate type)

• track_type: "video", "audio", or "subtitle" (default: "video")

• track_index: 1-based track index (default: 1)

• item_index: 0-based index of the item in the track (default: 0)

Get the color grading node graph info for a timeline item. Must be on the Color page with a clip selected.

Parameters:

• track_type: "video", "audio", or "subtitle" (default: "video")

• track_index: 1-based track index (default: 1)

• item_index: 0-based item index (default: 0)

Apply a LUT to a node in a clip's color node graph.

Parameters:

• node_index: 1-based node index

• lut_path: Absolute path to the LUT file (.cube, .3dl, etc.)

• track_type: "video" (default)

• track_index: 1-based track index (default: 1)

• item_index: 0-based item index (default: 0)

Apply CDL (Color Decision List) values to a node.

Parameters:

• node_index: 1-based node index

• slope: RGB slope as space-separated string (default: "1.0 1.0 1.0")

• offset: RGB offset as space-separated string (default: "0.0 0.0 0.0")

• power: RGB power as space-separated string (default: "1.0 1.0 1.0")

• saturation: Saturation value (default: 1.0)

• track_type/track_index/item_index: Clip locator

Get available render formats and codecs.

Parameters:

• render_format: If provided, returns codecs for that format. Otherwise returns all formats.

Get current render format, codec, render job list, and render presets.

Configure render settings for the current project.

Parameters:

• settings: Dict of render settings. Common keys: "TargetDir" (str), "CustomName" (str), "SelectAllFrames" (bool), "MarkIn" (int), "MarkOut" (int), "ExportVideo" (bool), "ExportAudio" (bool), "FormatWidth" (int), "FormatHeight" (int), "FrameRate" (float)

• render_format: Format string (e.g. "mp4", "mov"). Set together with codec.

• codec: Codec string (e.g. "H.264", "H.265", "ProRes 422 HQ")

Add a render job to the queue based on current render settings.

Start rendering queued jobs.

Parameters:

• job_ids: Optional list of job IDs to render. If None, renders all queued jobs.

Get the status of a render job.

Parameters:

• job_id: The render job ID (returned by add_render_job)

Stop any currently running render processes.

Create an AI-powered Magic Mask on a timeline item for subject isolation. Requires DaVinci Resolve Studio with Neural Engine.

Parameters:

• mode: "F" (forward), "B" (backward), or "BI" (bidirectional)

• track_type/track_index/item_index: Clip locator

Regenerate an existing Magic Mask on a timeline item.

Parameters:

• track_type/track_index/item_index: Clip locator

Apply Smart Reframe to a timeline item (AI-based reframing). Requires DaVinci Resolve Studio with Neural Engine.

Parameters:

• track_type/track_index/item_index: Clip locator

Apply stabilization to a timeline item using DaVinci Neural Engine. Requires DaVinci Resolve Studio.

Parameters:

• track_type/track_index/item_index: Clip locator

Detect scene cuts in the current timeline using AI. Requires DaVinci Resolve Studio.

Generate subtitles from audio using AI speech recognition. Requires DaVinci Resolve Studio 19+.

Parameters:

• language: "auto", "english", "french", "german", "italian", "japanese", "korean", "mandarin_simplified", "mandarin_traditional", "portuguese", "russian", "spanish", "danish", "dutch", "norwegian", "swedish"

• preset: "default", "teletext", or "netflix"

• chars_per_line: Characters per line (1-60, default: 42)

• line_break: "single" or "double"

• gap: Gap between subtitles in frames (0-10, default: 0)

Get all Fusion compositions associated with a timeline item.

Parameters:

• track_type/track_index/item_index: Clip locator

Add a new Fusion composition to a timeline item.

Parameters:

• track_type/track_index/item_index: Clip locator

Import a Fusion composition from file into a timeline item.

Parameters:

• comp_path: Absolute path to the .comp or .setting file

• track_type/track_index/item_index: Clip locator

Export a Fusion composition from a timeline item to a file.

Parameters:

• export_path: Destination file path

• comp_index: 1-based Fusion composition index (default: 1)

• track_type/track_index/item_index: Clip locator

Load a named Fusion composition as the active composition.

Parameters:

• comp_name: Name of the Fusion composition to load

• track_type/track_index/item_index: Clip locator

Delete a named Fusion composition from a timeline item.

Parameters:

• comp_name: Name of the Fusion composition to delete

• track_type/track_index/item_index: Clip locator

Rename a Fusion composition on a timeline item.

Parameters:

• old_name: Current name of the Fusion composition

• new_name: New name for the composition

• track_type/track_index/item_index: Clip locator

Create a Fusion clip from one or more timeline items.

Parameters:

• track_type: "video" (default)

• track_index: 1-based track index (default: 1)

• item_indices: List of 0-based item indices to merge. If None, uses all items.

Insert a Fusion generator into the current timeline at the playhead.

Parameters:

• generator_name: Name of the Fusion generator to insert

Insert a blank Fusion composition into the current timeline at the playhead.

Insert a Fusion title into the current timeline at the playhead.

Parameters:

• title_name: Name of the Fusion title template to insert

Export the current timeline to a file.

Parameters:

• file_path: Destination file path

• export_type: One of "aaf", "drt", "edl", "fcp_7_xml", "fcpxml_1_8", "fcpxml_1_9", "fcpxml_1_10", "hdr_10_profile_a", "hdr_10_profile_b", "csv", "tab", "otio", "ale", "ale_cdl"

• export_subtype: For AAF: "aaf_new" or "aaf_existing". For EDL: "cdl", "sdl", "missing_clips", or "none".

Get a thumbnail of the current frame from the Color page. Must be on the Color page with a clip selected.

Export the current frame as a still image.

Parameters:

• file_path: Destination file path (.png, .jpg, .tif, .dpx, .exr)

Take a screenshot of DaVinci Resolve so you can SEE the current state. Call this frequently — before and after changes, when the user describes something visual, or whenever you need to verify what's on screen. Captures the Resolve window directly. Works on any page.

Get the Voice Isolation state for an audio track. Requires DaVinci Resolve Studio.

Parameters:

• track_index: 1-based audio track index

Set Voice Isolation on an audio track to isolate speech from background noise. Requires DaVinci Resolve Studio.

Parameters:

• track_index: 1-based audio track index

• enabled: True to enable, False to disable

• amount: Isolation amount (0-100, default: 100)

Execute arbitrary Python code in the DaVinci Resolve scripting environment. Use this for operations not covered by specific tools.

Pre-loaded namespace variables:

• resolve: The DaVinci Resolve object

• project: The current project

• mediaPool: The current media pool

• timeline: The current timeline (may be None)

• mediaStorage: The media storage object

Use print() to output results, or set a variable named 'result'.

Parameters:

• code: Python code to execute

Transcribe an audio/video file locally using mlx-whisper (Apple Silicon). Long files are automatically split into 5-minute chunks so it never times out.

Returns ALL segments with timestamps inline (compact format) plus saves an SRT file next to the source for Resolve import.

Parameters:

• file_path: Absolute path to audio/video file (mp3, wav, m4a, mp4, mov, etc.)

• model: "tiny" (fastest), "base", "small", "medium", "large" (most accurate), "turbo" (best speed/quality, default). Or a full HuggingFace repo path.

• language: Language code (e.g. "en", "fr", "de", "ja"). None = auto-detect.

• word_timestamps: Include word-level timestamps in output.

• initial_prompt: Optional text to guide the model's vocabulary/style.

Transcribe audio locally with mlx-whisper and add subtitle markers to the timeline. Long files are auto-chunked so this works on any length.

Parameters:

• file_path: Absolute path to the audio/video file to transcribe

• model: Whisper model size ("tiny", "base", "small", "medium", "large", "turbo")

• language: Language code (e.g. "en", "fr"). None = auto-detect.

• initial_prompt: Optional text to guide recognition vocabulary

Transcribe audio and save as an SRT subtitle file. The SRT can then be imported into Resolve's subtitle track.

Parameters:

• file_path: Absolute path to the audio/video file to transcribe

• output_path: Where to save the .srt file

• model: Whisper model size ("tiny", "base", "small", "medium", "large", "turbo")

• language: Language code or None for auto-detect

• initial_prompt: Optional vocabulary/style hint

List available mlx-whisper models with their HuggingFace repo paths.