editly

Editly is a framework for declarative NLE (non-linear video editing) using Node.js and ffmpeg. It allows you to easily and programmatically create a video from set of videos, images and titles, with smooth transitions between.

Also provides a simple command line for quickly assembling a video.

Inspired by ffmpeg-concat. The problem with that project is that it uses an extreme amount of disk space, especially for HD/4K videos. This projects solves that by doing streaming editing, so it doesn't store any temporary files.

Requirements

Node.js installed (Recommended to use newest stable version)
Should work on Windows, MacOS and Linux. The command line utility needs at least Node.js v12.16.2 (see issue). See also https://github.com/stackgl/headless-gl#system-dependencies

Make sure you have ffmpeg and ffprobe installed and available in PATH

Installing

npm i -g editly

CLI video editor

Run editly --help for usage

Create a simple randomized video edit from videos, images and text

editly \
  title:'My video' \
  clip1.mov \
  clip2.mov \
  title:'My slideshow' \
  img1.jpg \
  img2.jpg \
  title:'THE END' \
  --audio-file-path /path/to/music.mp3 \
  --font-path /path/to/my-favorite-font.ttf

Or create a GIF (or MP4) from a JSON edit spec

editly --json my-editly.json --out output.gif

For examples of how to make an JSON edit spec, see https://github.com/mifi/editly/tree/master/examples

By default it will use the width, height and frame rate from the first input video. all other clips will be converted to these dimensions You can override these parameters however.

TIP: Run with --fast or fast: true first to improve speed while testing

Javascript library

const editly = require('editly');

// See editSpec documentation
await editly(editSpec)
  .catch(console.error);

Features

Custom Canvas/Fabric.js rendering
Can output the same video to multiple sizes, like Instagram post, Instagram story 9:16, YouTube 16:9, or any dimensions you like
TODO add more

TODO

Implement audio from source files
Allow specifying path to ffmpeg and ffprobe
Full power of the HTML to create visuals and animations (maybe puppeteer)
three.js

2.4 KiB Raw Blame History