Final Cut Pro X - XML File

[cbitterfield]

Description of Problem & Solution

Request the ability export scene cut information directly to a FInal Cut Pro XML file.

Media Examples:

Guide to XML
https://support.apple.com/guide/final-cut-pro/use-xml-to-transfer-projects-verdbd66ae/mac.

Proposed Implementation:

From what I understand it is the same information as the CSV file but in "FCPX" XML format

Alternative Solutions:
Writing a python converter between the CSV output and the XML format.

[Breakthrough]

I found this on the developer documentation about the XML format itself, but could definitely use some pointers for where to start. The XML looks a lot more involved than just the CSV though at a first glance. If you could provide an example XML that would be helpful for me to judge the effort required to implement this.

Thank you!

[Breakthrough]

Marking as on-hold until further information can be gleaned as to the scope of this feature. Closing issue to cleanup backlog, feel free to re-open in future if desired.

[camjac251]

I am very interested in a feature like this. Having it could save a lot of time with my workflow and also hopefully fix a few quirks with the current one (like with colorspace conversion or disk space required for lossless conversions)

[camjac251]

I tried to find if someone else might've made something like this before but could only find https://github.com/Mirellanmawl/PySceneDetect-CSV-to-Vegas-EDL and https://github.com/duolanda/scene-detect-to-xml
The second one I believe takes the final clip video files generated by PySceneDetect and creates an FCP XML from that, instead of using the CSV output as an input

[Breakthrough]

If you can provide an example of what this XML should look like I can certainly look into adding support for it. I don't have Final Cut Pro so I will need some assistance with testing as well.

Could add a few new commands to the CLI like save-csv, save-xml, and save-edl - just need a library of samples for the output format.

[camjac251]

I can work on that, to get one to you. I use Premiere Pro and Davinci Resolve. FCP XML is pretty much supported with all major NLEs luckily and has been better for me than EDL. You could save one out or import one in both programs.
It might take me a little while to create a test example but maybe this might be more helpful https://developer.apple.com/documentation/professional_video_applications/fcpxml_reference
https://github.com/Cubxity/ResolveParser
or the work that this user has done https://github.com/duolanda/scene-detect-to-xml/blob/main/xml_creator.py
or https://github.com/ldsxp/fcpxml/blob/master/fcpxml/fcp.py

[Breakthrough]

Awesome, yeah if we can just get the most simplest "ground truth" XML so to speak I can use that as the test case for validation purposes. Ideally it would just be a short clip with 3 or more cuts, can just be manually placed. I'm also curious if you can specify a shorter start/duration if for example the time command was used.

If this XML could be validated on all of the programs you mentioned as well then it should be no problem at that point in adding a new command. One open question I have that might need some testing is how robust these parameters need to be:

    <format id="r1" name="FFVideoFormat1080p30"/>
    <asset id="r2" start="0s" duration="10s" hasVideo="1" hasAudio="1" format="r1" audioSources="1" audioChannels="2" audioRate="48000">
        <media-rep kind="original-media" src="file:///Volumes/media/MyMovie1.mov"/>
    </asset>

I'm assuming some of that information can be simply omitted (edit: looks like that may be the case indeed), so hoping we can come up with the smallest example that works with all of those programs you listed. Thanks!

The smallest thing I think is something like (with some of my own comments inline for things that need to be determined):

<fcpxml version="1.10">
    <resources>
        <!-- can format be omitted? -->
        <format id="r1" name="FFVideoFormat1080p30"/>
        <!-- can start/duration be omitted?  can they be overriden?  if so how does it affect start/duration in the clips below? -->
        <asset id="r2" start="0s" duration="10s">
            <media-rep kind="original-media" src="file:///Volumes/media/MyMovie1.mov"/>
        </asset>
    </resources>
    <event name="Scenes">
        <!-- can format be omitted? can audio_role be omitted? -->
        <!-- what does setting offset (e.g. offset="5s") do? -->
        <asset-clip name="scene1" ref="r2" format="r1" start="0s" duration="10s" audioRole="dialogue"/>
        <asset-clip name="scene2" ref="r2" format="r1" start="0s" offset="5s" duration="20s" audioRole="dialogue"/>
        <asset-clip name="scene3" ref="r2" format="r1" start="10s" duration="40s" audioRole="dialogue"/>
    </event>
</fcpxml>

[camjac251]

I've created a few test files in Davinci Resolve and Premiere Pro. I hope they might be useful. I took this video from http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4, imported it into Davinci Resolve, onto a timeline, and ran the cut detection in the app which went through and added splices for each cut. That is the base for all of these files. I then exported it out of Resolve with the FCP 7 XML V5 Files option which creates an XML file. There were other options like FCPXML 1.9 which might've been what I linked above but the extension .fcpxml isn't detected when I go to import in Premiere, even after renaming to XML. FCP 7 XML V5 works though. I exported this from Davinci and imported it into Premiere and re-exported it with the Final Cut XML option. I did this for a timeline with audio and without. I can't upload an XML file directly on GitHub, but was able to zip them up and upload that.
AllFCPXMLs.zip

According to this https://helpx.adobe.com/premiere-pro/how-to/migrate-from-final-cut-pro.html Final Cut Pro X generated files aren't compatible with Premiere, but older FCP7 files would be.

[camjac251]

Here's the documentation for the FCP 7 XML format https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/FinalCutPro_XML/AboutThisDoc/AboutThisDoc.html#//apple_ref/doc/uid/TP30001152-TPXREF101

I saw this as well which might be cool as a library to use in PySceneDetect https://opentimelineio.readthedocs.io/en/latest/tutorials/adapters.html https://github.com/PixarAnimationStudios/OpenTimelineIO