Creating Scripts for DaVinci Resolve

I'm trying to remember how that worked. Did it move only the media associated with a timeline or a project? Did it relink to the media at the new location? I think both those are possible to achieve, although I'd have to test the relinking. I'm not sure that I ever attempted that.

Would Resolve Collect not work for you: https://www.niwa.nu/resolve-collect/

Wow incredible to see this thread. Really hoping to see more functionality with the API!

I've been racking my brain trying to find/figure out how to convert used clips in a timeline into marker durations within the media pool.

its easy 2 step process manually but with hundreds of clips in a timeline, a script to do so would be life changing...

FYI in case people don't spot it:

Forum Suggestion: Add a DR Scripts Forum
https://forum.blackmagicdesign.com/viewtopic.php?f=21&t=180039

A bit too much on my plate right now to make it a fully finished script. But this might get you started at least.

Code: Select all

local project = resolve:GetProjectManager():GetCurrentProject()
local timeline = project:GetCurrentTimeline()
local marker_colors = table.pack("Blue", "Cyan", "Green", "Yellow", "Red", "Pink", "Purple", "Fuchsia", "Rose", "Lavender", "Sky", "Mint", "Lemon", "Sand", "Cocoa", "Cream")

for track_index = 1, timeline:GetTrackCount("video") do
   local track_name = timeline:GetTrackName("video", track_index)

   for _, timeline_item in ipairs(timeline:GetItemListInTrack("video", track_index)) do
      local media_pool_item = timeline_item:GetMediaPoolItem()
      media_pool_item:AddMarker(timeline_item:GetLeftOffset(), marker_colors[(track_index - 1) % #marker_colors + 1], "Track: "..track_name, "", timeline_item:GetDuration())
   end
end


It's "dumb" in the sense that it doesn't clear existing media pool item markers, doesn't check if the same in point is used more than once (which will make it ignore that timeline clip) and it only looks at video, not audio.

One thing to note is that the visual out point of a marker isn't inclusive of the frame duration. So it will look like it's one frame short even though the numbers are correct. If you want to change it for some reason, just replace timeline_item:GetDuration() with timeline_item:GetDuration() + 1.

Wow Roger thanks for this - even in it's raw form it works for my needs.

I tweaked it to also add markers for tracks 2 and so on, which is a great way to add specific labels to all the clips selected.

When pulling usable selects I keep them on track one and label the track "Selects" and move favorites to track 2 and label the track "Selects Favorites"

and after running the script the duration markers are applied with those titles

I feel like this has so much more potential for choosing marker colors and even labeling which timeline media is used until Blackmagic gives us that feature.

You know what script would be super helpful? If you could extract the Date Created metadata from the file and generate timecode off that for a file. I've got a camera card I just inherited that ran continuous timecode but I'm trying to make it TOD. Even if I could get it close, I could sync from there. Right now it's just a mess.

Can't offer such a script, but there's external software offering just that, like EditReady.

That's an easy change for the "Set Timecode for Media Pool Clips" script. I have added a checkbox that lets you create timecode from the "Date Created" metadata field instead.


Post: Set Timecode for Media Pool Clips [Download]

Can anyone confirm there is no method to get or set the TimelineItem speed? I'm trying to find all clips in a timeline that have a speed change but can't find any method in the API.

Last time I needed that maybe three years ago there wasn't one. I don't recall seeing it added. I think you can get enough information to calculate it yourself, but you can't calculate if there are keyframed speed ramps.

If you export the timeline to an OpenTimelineIO file (a JSON file) in 18.5 Beta 3 or later, you can get both the clip speed and keyframes.

Code: Select all

local project = resolve:GetProjectManager():GetCurrentProject()
local timeline = project:GetCurrentTimeline()
timeline:Export([[D:\Temp\timeline.otio]], resolve.EXPORT_OTIO)


Resolve 18.5 Beta 2 has added those improvements to the scripting API:

• Scripting API support to create subtitles from timeline audio.
• Scripting API support to transcribe source clips.

Resolve 18.5 Beta 3 has added another few improvements to the scripting API:

• Scripting API support to trigger object mask tracking.
• Scripting API support to trigger stabilization.
• Scripting API support to invoke scene cut detection in timelines.
• Scripting API support to enable smart reframe for clips.
• Scripting API support to export current frame as still.
• Scripting API for adding subclips to the media pool.
• Scripting API support to export and import OpenTimelineIO files.
• Scripting API support to render PNG and JPEG image sequences.

Isn't it strange to have a Stabilize() function that doesn't allow you to set any of the stabilization parameters? I wonder what the use case is here.

They've added some useful functions to Timeline Items, but there's no way through the API to find out which items are selected on the timeline. So how would it be used?

Isn't it strange to have a Stabilize() function that doesn't allow you to set any of the stabilization parameters? I wonder what the use case is here.

My guess is this is just a result of the new ability to do batch stabilization of selected clips. Hopefully this gets improved with parameter settings.

If you export the timeline to an OpenTimelineIO file (a JSON file) in 18.5 Beta 3 or later, you can get both the clip speed and keyframes.

Code: Select all

local project = resolve:GetProjectManager():GetCurrentProject()
local timeline = project:GetCurrentTimeline()
timeline:Export([[D:\Temp\timeline.otio]], resolve.EXPORT_OTIO)


Nice!
Thank you

They've added some useful functions to Timeline Items, but there's no way through the API to find out which items are selected on the timeline. So how would it be used?

I guess you can setup markers to flag the clips and then set the playhead to the timecode and get the timeline items that way.

Is there a program that supports regular expressions for writing code quickly?

If you export the timeline to an OpenTimelineIO file (a JSON file) in 18.5 Beta 3 or later, you can get both the clip speed and keyframes.

Code: Select all

local project = resolve:GetProjectManager():GetCurrentProject()
local timeline = project:GetCurrentTimeline()
timeline:Export([[D:\Temp\timeline.otio]], resolve.EXPORT_OTIO)


That's a pretty decent workaround.

Scripting API support to render PNG

I wish this for so long! Anyone would develop the script?

I'm trying to remember how that worked. Did it move only the media associated with a timeline or a project? Did it relink to the media at the new location? I think both those are possible to achieve, although I'd have to test the relinking. I'm not sure that I ever attempted that.

Would Resolve Collect not work for you: https://www.niwa.nu/resolve-collect/

Thanks Igor I am going to play around with this!

Scripting is a great feature in DaVinci Resolve. With the exception of a few brave souls that have shared their scripts the forum isn't exactly overflowing with them so I thought I'd make a few contributions on the subject.

Thank you!!!

Isn't it strange to have a Stabilize() function that doesn't allow you to set any of the stabilization parameters? I wonder what the use case is here.

They've added some useful functions to Timeline Items, but there's no way through the API to find out which items are selected on the timeline. So how would it be used?

Drx can save specific stabilizer parameters if i remember correctly.
So we could apply a dummy drx with the preferred parameters.

Enviado desde mi Mi 9 Lite mediante Tapatalk

Resolve 18.5 Beta 4 has added those improvements to the scripting API:

• Support to add, delete, enable and lock timeline tracks.
• Support to delete and link timeline clips.
• Support to specify target track and record frame to add clips to timeline.
• Support to specify record frame to create timeline from media pool clips.

Those were available even before 18.5 but undocumented. They were removed in Beta 3. Thankfully they are now officially available and documented.

I got an idea for a hopefully useful script for many users:

The problem:
I have created lower third templates for different purposes, with two text+ inputs for "name" and "function". That works great, no problem.
But I have to fill in the inputs over and over again when having the same people in different projects.

It would be cool to have a script which reads from a text file all names and functions and let me select from a list for semi-auto fill in the lower thirds.

The text file could e.g. consist of something like this:

[groupname]
<first name> <last name>, <function>;
<first name> <last name>, <function>;
.
.
.
<first name> <last name>, <function>;
[/groupname]

Then if the lower third comp is selected start the script and get a drop down list with all groups to select one from and then the list of names (sorted by last name). If selected a name and hit enter you get the lower third's inputs populated.

It'd be cool if entering a character a-z (and special characters like umlaut or what ever other languages have) selection would jump in the list to that last name beginning with that character.

And make a checkbox for the name fill in order: <first name> <last name> or <last name> <first name>
Maybe another checkbox to make <last name> all caps optionally.

I have seen there is some groundwork already there in this thread:
https://www.steakunderwater.com/wesuckl ... 208#p12208

I have no idea if this would be a lot of coding work or if this could be done quite fast (for myself would need a long time because I would have to start learning scripting first again).

Looking forward what others think about this. Maybe this already exists, but I haven't found anything like that so far, but I can't be the only one wanting something like this to improve working with lower thirds and minimizing typing errors and such.

@roger.magnusson

Do you (or anyone else here) have any working examples of basic UI windows and widgets being instatiated from python? (rather than lua)

Resolve 18.6 has added those improvements to the scripting API:

• Scripting API support to import and export render and data burn presets.
• Scripting API support to import stills and list powergrades.
• Scripting API support for per-timeline Resolve Color Management.

Do you (or anyone else here) have any working examples of basic UI windows and widgets being instatiated from python?

Here is a collection of Python-based UI Manager GUI creation examples. It comes from the Reactor package manager's "UI Manager Examples" atom package.

Im amazed at how much work is being done here. Im not a programmer so ill ask for help here.

Since DR now has API support for creating sutbtitles from timeline audio. Is it possible to create a script the makes longer blocks of text. So instead of creating 60 characters per line max, to being able to put together a timed amount (say 5 minutes) of subtitles in one block.

My use case is this. I have a 8x 2 hour interviews that was subtitled. I converted the subtitle.SRT to Timeline Index and import back into resolve just so i can search using the INDEX. However the Timeline markers brings in about 2500 markers on average. Which immediatley bogs the system down making it unusable.

Possible solutions:
1. Create longer subtitle blocks that capture more text.
2. Have the ability to search subtitles (as is in DR) to filter and list by search, while still being able to move to timecoded area.

Thanks for the assitance in advance.

As BMD doesn't yet provide a built-in method to find / filter subtitle track contents...

Screenshot 2023-09-26 113951.jpg (31.94 KiB) Viewed 1125 times

Andy's Subvigator is a helper that displays the active timeline's subtitles (from a chosen subtitle track) together with a case-insensitve text filter for searching those subtitles. Selecting any subtitle/block in the Subvigator window moves the timeline playhead to the start of the corresponding subtitle/block (for editing the source in the timeline). Search options are Contains, Exact, Starts With, Ends With and Wildcard (using asterisks). Enabling the 'Dynamic search text' option will update the search results as you type... great if you don't have too many subtitles to filter, otherwise just press <Enter> or <Return> to trigger the search. The 'Combine Subs' option groups and navigates subtitles as blocks, the number of subtitles per block being the number you choose... useful when working with massive subtitle lists (it acts like a speed multiplier!) but note that, when used, navigational accuracy is effectively reduced by the same factor. If working in a Drop Frame timeline, enable the the 'DF navigation' option (functionality courtesy of Roger Magnusson's Libavutil code posted earlier in this thread).
Finally, the manual 'Refresh' button rebuilds the list to reflect any changes in the timeline.

[Save to your Scripts or Workflow Integration folder]

For the adventurous, apart from cleaning up and optimising my lazy code, this basic helper could be updated to support: editing the displayed subtitles, adding a 'find and replace' function, adding spellcheck functionality and whatever else you might want to have a go at, then sending those changes back to the project via SRT).

Hope its useful
Cheers
Andy

Here's a (Lua driven) helper to search & navigate subtitles:

Screenshot 2023-09-20 220617.jpg

BMD doesn't yet provide a built-in method to find / filter subtitle track contents... this helper displays subtitles as a static list in a separate window and adds that missing text search capability. Clicking any row move's the timeline playhead to the selected subtitle (for editing the source in the timeline). The manual 'Refresh' button rebuilds the list to reflect any changes.

[Save to your Scripts or Workflow Integration folder]

For the adventurous, apart from cleaning up and optimising my lazy code, this basic helper could be updated to support: editing the displayed subtitles, adding a 'find and replace' function, adding spellcheck functionality and whatever else you might want to have a go at, then sending those changes back to the project via SRT).

Fair warning: I've only used this on 25p projects.... the timecode conversion routine will need help to work accurately on fractional timebases.

Hope its useful
Cheers
Andy

***edit***


Thanks for offering this Andy. It works as it should. I wished it worked more efficiently in the workflow. But im sure someone will find this useful.

Thanks again. I appreciate the work you guys do here. Picked up a couple aswesome scripts here. If i wanted to learn to create stuff like this where could find some resources.

Thanks Golden

It works as it should

Cool.
FYI, I just updated the script to add a 'Use dynamic filter' checkbox control to the UI (default status: off) When working with large numbers of subtitles, having dynamic filtering turned off helps responsiveness dramatically... instead of triggering the filter to rebuild itself after every keypress, it waits for you enter all search text first, then manually trigger the filter by pressing <Enter> or <Return>.

If i wanted to learn to create stuff like this where could find some resources.

If you go to Resolve's Help menu > Documentation > Developer it will take you to the Support / Developer folder in your Resolve install which contains many scripting and workflow integration code samples. Especially, check the 'ReadMe' file in the Scripting folder. If that whets your appetite, you should join the WeSuckLess forum where there's a world of super helpful people with lots of relevant code that' s freely shared.

Just installed Andy's script
Thanks to you and Roger

Thanks Andy. I'll give it another shot.

UPDATE.

Rafael at editingtools.io made some changes to merge subtitles.

1. Create subtitles from Audio in Davinci Resolve. Filetype:SRT
Rafael at editingtools.io made it possible to set a time in seconds to merge subtitles.
2. Go to https://editingtools.io/subtitles/ and convert the SRT file to 15 seconds merged SRT. Remember to click "remove tags".
3. Go to https://editingtools.io/marker and convert Merged SRT to Timeline Markers. Check the "Swap marker name..." Filetype: EDL
4. Select Timeline in the BIN in DR, right click and import Timeline Markers.
i. If you are using (Andy's Subvigator) to subtitle search import merged subtitle and add to timeline.
ii. use Andy's Subvigator to search subtitles with "Use dynamic..." UNCHECKED.
5. You can use the index in DR to navigate by search.

Performance should be better since the number of indexes are reducded, based on the seconds selected to merge in Step 2.

Andy thanks again for the script & Rafael at editingtools.io

**ORIGINAL POST**
Just wanted to leave some feedback for reference.

Thanks for the update on the script it has definitely increased productivity.

The following is the workaround. It involves a bit of round-tripping.

(Create Subtitle)
1. Create subtitles from Audio in Davinci Resolve. Filetype:SRT
(Reduce the amount of Subtitles make longer text blocks. My project was reduced from 2500 to 498 subtitles)
2. Go to https://editingtools.io/marker/ and convert subtitles to Timeline Markers. Check the "Swap marker name..." and "Merge marker 10 seconds" This step removes tags and reduces the amount of subtitle lines generated for the timeline markers. Filetype: EDL
(Only way to have converted subtitles that'll keep text and timecode location)
3. Select Timeline in the BIN in DR, right click and import Timeline Markers.
4. Right click on Timeline again and export Timeline Markers. Filetype:EDL
5. Go back to editingtools.io and convert EDL to SRT
6. Import SRT into DR and drag to timeline.
7. Use Andy's Subvigator to search subtitles with "Use dynamic..." UNCHECKED.

Andy thanks again for the script & Rafael at editingtools.io

Hi Folks,

I'm an On/Near Set DIT working on TV show and feature with SilverStack Lab, LiveGrade, Avid Media Composer, Davinci Resolve, Base Light an many more.

Fist I wanted to thank Roger Magnusson for the Timeline Clips Batch Timecode Script, wich realy realy rocks in peculiars workflows where you need to batch offset TC from already imported Audio File inside Resolve MediaPool before Sync.
For now Resolve "Import with offset" doesn't work for audio files, only video clips. And Roger you made it possible since 2015!

As I have realy poor knowlege of Python and Lua, I wonder if there is an easy way to implement another option in the "mode" dropdown menuof the script. An option called "Audio Offset" that would add, substract or even set the existing clip audio Offset column (for now you can only do it by hand and clip per clip)
That way the TC would not be touch but you'll still get the offset correction directly on the synced clips. Modifed TC could be a great deal when exporting clips for Post-Production houses that would have trouble to correctly relink the clip to the original one if the Resolve TC is changed on Proxy or other exported files.

If you guide me maybe I would be able to add that change in the existing script.

Thank again

Genius!!! Thank you so much for the really useful script!!

I tested "Grab Stills at Markers.lua" on mac in18.6. It does not work now.

截屏2023-11-04 16.53.34.png (70.56 KiB) Viewed 460 times