VTT-Editor

Use VTT files to edit film. Using MELT, ffmpeg and co.

Requirements

• mltframework
• ffmpeg from GIT (compiled with libfaac & libx264)
• mplayer (cuz its a reliable way to get framerate)
• node.js
• posix shell
• detox

Install

For Mac Users:

brew install mlt detox mplayer

For Linux Users:

apt-get update && apt-get install mlt detox mplayer

Then:

git clone git@github.com:denjello/VTT-Editor.git
cd VTT-Editor
npm install

At the moment there are two main services:

MASHUP A FOLDER

Example: ./mashup_folder.js -i="/home/user/videos/" -o="test.mp4

Options:
  -i, --inputfolder   input folder with trailing slash                [required]
  -o, --outputfile    output file with mime suffix                    [required]
  -v, --verbose       Use -v=true for extra info                [default: false]
  -y, --system        Use --system=osx if on mac              [default: "linux"]
  -s, --sensitivity   sensitivity of scene detection greater than zero and less
                      than one                                    [default: 0.1]
  -n, --framemin      Min number of frames per scene. Scenes with less than this
                      number of frames will be ignored. It defaults to detected
                      frames per second (fps).                      [default: 1]
  -x, --framemax      Max number of frames per scene as a positive whole number
                      , greater than or equal to framemin. If the scene has more
                      frames than framemax, it will be cut at this number of
                      frames. It defaults to frames per second (fps).
                                                                    [default: 1]
  -r, --randomorder   If set to true will randomly slice and dice the file(s)
                      and put them into your output fuile       [default: false]
  -l, --randomlength  If set to true, it will choose a length between the
                      framemin and framemax, but always lower than the
                      scenelength                               [default: false]
  -b, --batch         If used it will not transcode, but rather return an
                      edl.                                      [default: false]

Here is another example that cuts up all of the video files in the folder ~/Videos with a relatively high accuracy of 0.01 (to scene changes) with a minimum cut length of 5 frames and a maximum cut length of 15 frames, random with verbose output:

$ ./mashup_folder.js --inputfolder='~/Videos' --outputfile='test.mp4' --sensitivity=0.01 --framemin=5 --framemax=15 --randomorder=true --randomlength=true --verbose=true

DROP BORING PARTS OF ONE FILE

Example: ./edl_dropboring.js -i="/home/user/videos/demo.mp4" -o="test.mp4"

Options:
  -i, --inputfile     input file                                      [required]
  -o, --outputfile    output file with mime suffix                    [required]
  -v, --verbose       Use -v for extra info                     [default: false]
  -y, --system        Use --system=osx if on mac              [default: "linux"]
  -s, --sensitivity   sensitivity of scene detection greater than zero and less
                      than one]                                   [default: 0.1]
  -n, --framemin      Min number of frames per scene. Scenes with less than this
                      number of frames will be ignored. It defaults to detected
                      frames per second (fps).                      [default: 1]
  -x, --framemax      Max number of frames per scene as a positive whole number
                      , greater than or equal to framemin. If the scene has more
                      frames than framemax, it will be cut at this number of
                      frames. It defaults to frames per second (fps).
                                                                    [default: 1]
  -r, --randomorder   If set to true will randomly slice and dice the file(s)
                      and put them into your output fuile       [default: false]
  -l, --randomlength  If set to true, it will choose a length between the
                      framemin and framemax, but always lower than the
                      scenelength                               [default: false]
  -b, --batch         If available it will not transcode, but rather return an
                      edl.                                      [default: false]

Roadmap

• Integrate yargs for command line parsing
• Detox Filenames to make them safe crossplatform (submodule → detox.js)
• Rewrite detox.js to be node native and not require detox
• Determine file framerate (mplayer -identify)
• Drop requirement for mplayer and recycle ffprobe call
• Drop file dependency
• Autogenerate scene-cuts based on visual frame difference over time (ffprobe)
• Read files line-by-line into node (submodule → liner.js)
• Remove boring scenes from any video (edl_dropboring.js)
• Randomize non-boring parts of a single film (edl_dropboring_random.js)
• Randomly mashup all non-boring scenes of video files in a single folder.
• Add iteration count to make longer videos
• Add target settings to melt command (height, width, codec etc.)
• Use a VTT file as a source
• Use a
• Integrate sphinx4 to make word-based subtitles with exact time-code.
• Use an English sentence as a source based on Sphinx4's mapping.
• Integrate openCV to do face-tracking and recenter the output
• Integrate frie0r filter chains
• Realtime video stream