Skip to content

moos/davinci-slide-builder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

davinci-slide-builder

NPM version

Generates an fcpxml (1.8) formatted timeline of stills that can be imported into Da Vinci Resolve to make a slideshow.

Motivation

Da Vinci Resolve (free version) is an excellent software for video editing, rivaling both Final Cut Pro and Adobe Premier Pro. Alas I found it a little limiting in auto generating a slideshow of stills, specifically in being able to sort the media (say randomly) or choosing varied duration time and/or transition effects.

Install it

Get node.js, then

npm i -g davinci-slide-builder

Example

$ slide-builder -d 3 -t 1 ~/pics/2005/img100*.jpg  ~/pics/2006/img100*.jpg > out.xml
$ cat out.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE fcpxml>
<fcpxml version="1.8">
    <resources>
<asset id="sb1" src="file://localhost/c:/Users/foo/pics/2005/img100.jpg" name="img100.jpg" />
<asset id="sb1" src="file://localhost/c:/Users/foo/pics/2005/img101.jpg" name="img101.jpg" />
<asset id="sb1" src="file://localhost/c:/Users/foo/pics/2005/img102.jpg" name="img102.jpg" />
<asset id="sb2" src="file://localhost/c:/Users/foo/pics/2006/img100.jpg" name="img100.jpg" />

    </resources>
    <library>
        <event name="slideshow #1">
            <project name="slideshow timeline">
                <sequence>
                    <spine>
<video ref="sb1" duration="75/24s" offset="0/24s" />
  <transition duration="12/24s" offset="69/24s" />
<video ref="sb2" duration="70/24s" offset="75/24s" />
  <transition duration="12/24s" offset="139/24s" />
<video ref="sb3" duration="66/24s" offset="145/24s" />
  <transition duration="12/24s" offset="205/24s" />
<video ref="sb4" duration="69/24s" offset="211/24s" />
  <transition duration="12/24s" offset="274/24s" />

                    </spine>
                </sequence>
            </project>
        </event>
    </library>
</fcpxml>

Then open Da Vinci Resolve, (new project) and "import timeline" from out.xml.

To shuffle slides:

$ slide-builder -d 3 -t 1 --sort rand ~/pics/2005/img100*.jpg  ~/pics/2006/img100*.jpg > out.xml

CLI options

$ slide-builder
Usage: slide-builder [options] files... > outfile.xml

Options                                                                                                
  --slideDuration, -d N             - duration of each slide (default: 5 sec)                               
  --transitionDuration, -t N        - duration of transition between each slide (default: 1 sec)            
                                        0 for no transition.                                                  
  --randomDuration, -r min,max,dist - randomize slide duration within this range (secs) with distribution
                                        "uniform" or "normal" (Gaussian) (default: 3,6,uniform)
  --name S                          - name of project                                                       
  --sort [by]                       - sort slides (see advanced options)

  (Use --advanced to show less-used options)                                                           

files... can be one or more glob patterns, e.g., "pics/slideshow/** pics/summer/**.jpg".               
(Use --globs to show more examples)

Change log

  • 1.2.1 More informative timeline name
  • 1.2.0 Rename CLI args and fix default handling
  • 1.1.1 Added npm keywords
  • 1.1.0 Refactored CLI arguments. Add -R normal and sort by name and extension.
  • 1.0.0 Initial version supporting fcpxml 1.8

License

This software is released under the terms of the MIT license.

About

Generates timeline XML of slides for Da Vinci Resolve

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published