Resolve#

class pybmd.resolve.Resolve(resolve_ip: str = '127.0.0.1', auto_start: bool = False)[source]

Bases: object

Resolve class. Init Davinci Resolve Object Base for everything

Init Davinci Resolve Object

Parameters:

resolve_ip (str, optional) – davinci resolve ip. Defaults to 127.0.0.1.
auto_start (bool, optional) – open davinci automatically if it’s not running, if you want to open davinci manually, change arg to false. Defaults to True.

Raises:

ResolveInitError – davinci resolve init failed.you need to check if davinci resolve is running.

Methods

`__init__`([resolve_ip, auto_start])	Init Davinci Resolve Object
`check_api_compatibility`(api_name)	Check if an API is compatible with current Resolve version.
`delete_layout_preset`(preset_name)	Deletes preset named preset_name.
`export_burn_in_preset`(preset_name, export_path)	Export a data burn in preset to a given path (string) if presetName (string) exists.
`export_layout_preset`(preset_name, ...)	Exports preset named preset_name to path preset_file_path.
`export_render_preset`(preset_name, export_path)	Export a preset to a given path (string) if presetName(string) exists.
`get_current_page`()	Returns the page currently displayed in the main window
`get_fairlight_presets`()	Returns a list of Fairlight preset names.
`get_keyframe_mode`()	Refer to section 'Keyframe Mode information' for details.
`get_media_storage`()	Returns the MediaStorage object to query and act on media locations.
`get_product_name`()	Returns product name.
`get_project_manager`()	Returns the ProjectManager object for currently open database.
`get_version`()	Returns list of product version fields in [major, minor, patch, build, suffix] format.
`get_version_info`()	Returns structured version information.
`get_version_string`()	Returns product version in "major.minor.patch[suffix].build" format.
`import_burn_in_preset`(preset_path)	Import a data burn in preset from a given presetPath (string)
`import_layout_preset`(preset_file_path, ...)	Imports preset from path 'preset_file_path'.
`import_render_preset`(preset_path)	Import a preset from presetPath (string) and set it as current preset for rendering.
`is_version_at_least`(version_str)	Check if current Resolve version is at least the specified version.
`list_incompatible_apis`()	List all APIs incompatible with current Resolve version.
`load_layout_preset`(preset_name)	Loads UI layout from saved preset named preset_name.
`open_page`(page_name)	Switches to indicated page in DaVinci Resolve.
`quit`()	Quits the Resolve App.
`save_layout_preset`(preset_name)	Saves current UI layout as a preset named preset_name.
`set_keyframe_mode`(key_frame_mode)	Refer to section 'Keyframe Mode information' below for details.
`update_layout_preset`(preset_name)	Overwrites preset named 'preset_name' with current UI layout.

Attributes

fusion

Returns the Fusion object.

delete_layout_preset(preset_name: str) → bool[source]

Deletes preset named preset_name.

Parameters:: preset_name (string)
Returns:: result
Return type:: bool

export_layout_preset(preset_name: str, preset_file_path: str) → bool[source]

Exports preset named preset_name to path preset_file_path.

Parameters:

preset_name (str)
preset_file_path (str)

Returns:

result

Return type:

bool

property fusion: Fusion: Returns the Fusion object.

get_current_page() → str[source]

Returns the page currently displayed in the main window

Returns:: Returned value can be one of (“media”, “cut”, “edit”, “fusion”, “color”, “fairlight”, “deliver”, None).
Return type:: str

get_media_storage() → MediaStorage[source]

Returns the MediaStorage object to query and act on media locations.

Return type:: MediaStorage

get_product_name() → str[source]

Returns product name.

Returns:: product name
Return type:: str

get_project_manager() → ProjectManager[source]

Returns the ProjectManager object for currently open database.

Return type:: ProjectManager

get_version() → list[source]

Returns list of product version fields in [major, minor, patch, build, suffix] format.

Returns:: list of product version fields
Return type:: list

get_version_string() → str[source]

Returns product version in “major.minor.patch[suffix].build” format.

Returns:: product version string
Return type:: str

get_version_info() → Version[source]

Returns structured version information.

Returns:: Version object with major, minor, patch components
Return type:: Version

Example

>>> resolve = Resolve()
>>> version = resolve.get_version_info()
>>> print(f"Running Resolve {version}")
Running Resolve 20.2.0
>>> version.major
20

is_version_at_least(version_str: str) → bool[source]

Check if current Resolve version is at least the specified version.

Parameters:: version_str (str) – Version string like “20.0.0” or “19.1”
Returns:: True if current version >= specified version
Return type:: bool

Example

>>> resolve = Resolve()
>>> resolve.is_version_at_least("20.0.0")
True
>>> resolve.is_version_at_least("21.0.0")
False

check_api_compatibility(api_name: str) → Tuple[bool, str][source]

Check if an API is compatible with current Resolve version.

Parameters:: api_name (str) – Full API identifier (e.g., “TimelineItem.set_name”)
Returns:: Tuple of (is_compatible, status_message)
Return type:: Tuple[bool, str]

Example

>>> resolve = Resolve()
>>> is_ok, msg = resolve.check_api_compatibility("TimelineItem.set_name")
>>> print(f"TimelineItem.set_name: {msg}")
TimelineItem.set_name: API available

list_incompatible_apis() → List[Tuple[str, str]][source]

List all APIs incompatible with current Resolve version.

Returns:: List of (api_name, reason) tuples
Return type:: List[Tuple[str, str]]

Example

>>> resolve = Resolve()
>>> incompatible = resolve.list_incompatible_apis()
>>> for api_name, reason in incompatible:
...     print(f"❌ {api_name}: {reason}")

import_layout_preset(preset_file_path: str, preset_name: str) → bool[source]

Imports preset from path ‘preset_file_path’. The optional argument ‘preset_name’ specifies how the preset shall be named. If not specified, the preset is named based on the filename.

Parameters:

preset_file_path (str)
preset_name (str)

Return type:

bool

load_layout_preset(preset_name: str) → bool[source]

Loads UI layout from saved preset named preset_name.

Parameters:: preset_name (str)
Returns:: bool
Return type:: bool

open_page(page_name: str) → bool[source]

Switches to indicated page in DaVinci Resolve.

Parameters:: page_name (str) – Input can be one of (“media”, “cut”, “edit”, “fusion”, “color”, “fairlight”, “deliver”).
Returns:: bool
Return type:: bool

quit()[source]: Quits the Resolve App.

save_layout_preset(preset_name: str) → bool[source]

Saves current UI layout as a preset named preset_name.

Parameters:: preset_name (str)
Returns:: bool
Return type:: bool

update_layout_preset(preset_name: str) → bool[source]

Overwrites preset named ‘preset_name’ with current UI layout.

Parameters:: preset_name (str)
Returns:: bool
Return type:: bool

import_render_preset(preset_path: str) → bool[source]

Import a preset from presetPath (string) and set it as current preset for rendering.

Parameters:: preset_path (str) – path of preset file
Returns:: Returns True if successful, False otherwise.
Return type:: bool

export_render_preset(preset_name: str, export_path: str) → bool[source]

Export a preset to a given path (string) if presetName(string) exists.

Parameters:

preset_name (str) – export preset name
export_path (str) – export path

Returns:

Returns True if successful, False otherwise.

Return type:

bool

import_burn_in_preset(preset_path: str) → bool[source]

Import a data burn in preset from a given presetPath (string)

Parameters:: preset_path (str) – path of preset
Returns:: Returns True if successful, False otherwise.
Return type:: bool

export_burn_in_preset(preset_name: str, export_path: str) → bool[source]

Export a data burn in preset to a given path (string) if presetName (string) exists.

Parameters:

preset_name (str) – name of export preset
export_path (str) – path to export

Returns:

Returns True if successful, False otherwise.

Return type:

bool

get_keyframe_mode() → int[source]

Refer to section ‘Keyframe Mode information’ for details.

Returns:: currently set keyframe mode
Return type:: int

set_keyframe_mode(key_frame_mode: KeyframeMode) → bool[source]

Refer to section ‘Keyframe Mode information’ below for details.

Parameters:: key_frame_mode (KeyframeModeInformation) – key frame mode
Returns:: Returns True when ‘keyframeMode’(enum) is successfully set.
Return type:: bool

get_fairlight_presets() → list[source]

Returns a list of Fairlight preset names.

Returns:: List of Fairlight preset names available in the system.
Return type:: list

Resolve#

This Page