MediaPool#

class pybmd.media_pool.MediaPool(media_pool)[source]

Bases: object

MediaPool Object

Methods

`__init__`(media_pool)
`add_sub_folder`(folder, name)	add sub folder to folder
`append_to_timeline`(self, clips)	append clips to current timeline
`auto_sync_audio`(media_pool_items, ...)	Syncs audio for specified [MediaPoolItems] (list).
`create_empty_timeline`(name)	create empty timeline
`create_stereo_clip`(left_media_pool_item, ...)	Takes in two existing media pool items and creates a new 3D stereoscopic media pool entry replacing the input media in the media pool.
`create_timeline_from_clips`(name, clips)	create new timeline from clips with name
`delete_clip_mattes`(media_pool_item, paths)	Delete mattes based on their file paths for specified media pool item
`delete_clips`(clips)	Delete clips from media pool
`delete_folders`(subfolders)	delete folders from media pool
`delete_timelines`(timelines)	delete timelines from media pool
`export_metadata`(file_name[, clips])	export metadata to csv file
`get_clip_matte_list`(media_pool_item)	get list of clip mattes for specified media pool item
`get_current_folder`()	get current folder
`get_root_folder`()	return root folder object of media pool
`get_selected_clips`()	Returns the current selected MediaPoolItems
`get_timeline_matte_list`(folder)	Get mattes in specified Folder
`get_unique_id`()	get unique id of media pool object
`import_folder_from_file`(file_path, ...)	Returns true if import from given DRB filePath is successful, false otherwise
`import_media`(file_paths)	Imports specified file/folder paths into current Media Pool folder.
`import_timeline_from_file`(file_path, ...)	create new timeline from file and import options
`move_clips`(clips, target_folder)	Moves specified clips to target Folder
`move_folders`(folders, target_folder)	move folders to target folder
`refresh_folders`()	Updates the folders in collaboration mode
`relink_clips`(media_pool_items, folder_path)	Update the folder location of specified media pool clips with the specified folderpath
`set_current_folder`(folder)	set current folder
`set_selected_clip`(media_pool_item)	Sets the selected MediaPoolItem to the given MediaPoolItem
`unlink_clips`(media_pool_items)	Unlink specified media pool clips

add_sub_folder(folder: Folder, name: str) → Folder[source]

add sub folder to folder

Parameters:

folder (Folder) – folder to add sub folder to
name (str) – name of new sub folder

Returns:

folder object of new sub folder

Return type:

Folder

append_to_timeline(self, clips: List[ForwardRef('MediaPoolItem')]) → List[pybmd.timeline_item.TimelineItem][source]

append clips to current timeline

Parameters:: clips (List[MediaPoolItem]|List[ClipInfo]) – clips to append to current timeline
Returns:: timeline items of appended clips at timeline
Return type:: List[TimelineItem]

create_empty_timeline(name) → Timeline[source]

create empty timeline

Return type:: Timeline

create_timeline_from_clips(name: str, clips) → Timeline[source]

create new timeline from clips with name

Parameters:

name (str) – new timeline name
clips (_type_) – clips to create timeline from

Returns:

new timeline object

Return type:

Timeline

delete_clip_mattes(media_pool_item: MediaPoolItem, paths: List[str]) → bool[source]

Delete mattes based on their file paths for specified media pool item

Parameters:

media_pool_item (MediaPoolItem) – meida pool item to delete mattes for
paths (List[str]) – matte file paths to delete

Returns:

true if successful, false if not

Return type:

bool

delete_clips(clips: List[MediaPoolItem]) → bool[source]

Delete clips from media pool

Parameters:: clips (List[MediaPoolItem])
Return type:: bool

delete_folders(subfolders: List[Folder]) → bool[source]

delete folders from media pool

Parameters:: subfolders (List[Folder])
Return type:: bool

delete_timelines(timelines: List[Timeline]) → bool[source]

delete timelines from media pool

Parameters:: timelines (List[Timeline]) – list of timelines to delete
Returns:: true if successful, false if not
Return type:: bool

export_metadata(file_name: str, clips: List[MediaPoolItem] = None) → bool[source]

export metadata to csv file

Parameters:

file_name (str) – export metadata csv file name
clips (List[MediaPoolItem]) – clips to export metadata for If no clips are specified, all clips from media pool will be used.

Returns:

True if successful, False if not

Return type:

bool

get_clip_matte_list(media_pool_item) → List[Path][source]

get list of clip mattes for specified media pool item

Return type:: List[Path]

get_current_folder() → Folder[source]

get current folder

Returns:: current folder object
Return type:: Folder

get_root_folder() → Folder[source]

return root folder object of media pool

Returns:: root folder object
Return type:: Folder

get_timeline_matte_list(folder: Folder) → List[MediaPoolItem][source]

Get mattes in specified Folder

Parameters:: folder (Folder) – folder to get mattes for
Returns:: list of media pool items that are mattes
Return type:: List[MediaPoolItem]

import_media(file_paths: List[str]) → List[MediaPoolItem][source]

Imports specified file/folder paths into current Media Pool folder.

Parameters:: file_paths (List[str]) – Input is an array of file/folder paths.
Returns:: Returns a list of the MediaPoolItem created.
Return type:: List[MediaPoolItem]

import_timeline_from_file(file_path: str, import_option: TimelineImportOptions) → Timeline[source]

create new timeline from file and import options

Parameters:

file_path (str) – timeline file path
import_option (TimelineImportOptions) – timelineimportoptions object

Returns:

timeline object

Return type:

Timeline

move_clips(clips: List[MediaPoolItem], target_folder: Folder) → bool[source]

Moves specified clips to target Folder

Parameters:

clips (List[MediaPoolItem]) – list of clips to move
target_folder (Folder) – target folder to move clips to

Returns:

true if successful, false if not

Return type:

bool

move_folders(folders: List[Folder], target_folder: Folder) → bool[source]

move folders to target folder

Parameters:

folders (List[Folder]) – folders to move
target_folder (Folder) – target folder to move folders to

Returns:

true if successful, false if not

Return type:

bool

relink_clips(media_pool_items: List[MediaPoolItem], folder_path: str) → bool[source]

Update the folder location of specified media pool clips with the specified folderpath

Parameters:

media_pool_items (List[MediaPoolItem]) – clips to relink
folder_path (str) – folder path to relink clips to

Returns:

True if successful, False if not

Return type:

bool

set_current_folder(folder: Folder) → bool[source]

set current folder

Parameters:: folder (Folder)
Return type:: bool

unlink_clips(media_pool_items: List[MediaPoolItem]) → bool[source]

Unlink specified media pool clips

Parameters:: media_pool_items (List[MediaPoolItem])
Return type:: bool

refresh_folders() → bool[source]

Updates the folders in collaboration mode

Return type:: bool

get_unique_id() → str[source]

get unique id of media pool object

Return type:: str

import_folder_from_file(file_path: str, source_clips_path: str) → bool[source]

Returns true if import from given DRB filePath is successful, false otherwise

Parameters:

file_path (str) – file path to DRB file
source_clips_path (str) – sourceClipsPath is a tring that specifies a filesystem path to search for source clips if the media is inaccessible in their original path, empty by default

Returns:

Returns true if import from given DRB filePath is successful, false otherwise

Return type:

bool

create_stereo_clip(left_media_pool_item: MediaPoolItem, right_media_pool_item: MediaPoolItem) → MediaPoolItem[source]

Takes in two existing media pool items and creates a new 3D stereoscopic media pool entry replacing the input media in the media pool.

Parameters:

left_media_pool_item (MediaPoolItem) – left media pool item
right_media_pool_item (MediaPoolItem) – right media pool item

Returns:

3D stereoscopic media pool entry

Return type:

MediaPoolItem

get_selected_clips() → List[MediaPoolItem][source]

Returns the current selected MediaPoolItems

Returns:: current selected MediaPoolItems
Return type:: List[MediaPoolItem]

set_selected_clip(media_pool_item: MediaPoolItem) → bool[source]

Sets the selected MediaPoolItem to the given MediaPoolItem

Parameters:: media_pool_item (MediaPoolItem) – selected MediaPoolItem
Returns:: Returns true if successful, false if not
Return type:: bool

auto_sync_audio(media_pool_items: List[MediaPoolItem], audio_sync_settings: AudioSyncSetting) → bool[source]

Syncs audio for specified [MediaPoolItems] (list). The list must contain a minimum of two MediaPoolItems - at least one video and one audio clip. #BUG NOT WORKING IN DR19.1.X because Resolve’s API not working

Parameters:

media_pool_items (List[MediaPoolItem]) – _description_
audio_sync_settings (AudioSyncSetting) – _description_

Returns:

Returns True if successful. Refer to ‘AudioSyncSetting’ section for details.

Return type:

bool

MediaPool#

This Page