mifi /editly

Slick, declarative command line video editing & API

★ 5,613⑂ 390👁 59⑃ 103● 222▤ 26
TypeScriptMITCreated 2020-04-15
More from this author
Download: v0.15.0-rc.1v0.15.0-rc.1 ↓12025-01-19
+1
Daily
5,613
stars
390
forks
59
watchers
103
prs
222
issues
26
releases

README

!

  !Build status 

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

Editly has a simple CLI for quickly assembling a video from a set of clips or images, or you can use its more flexible JavaScript API.

Inspired by ffmpeg-concat, editly is much faster and doesn't require much storage because it uses streaming editing. Editly aims to be very extensible and feature rich with a pluggable interface for adding new dynamic content.



This GIF / YouTube was created with this command: "editly commonFeatures.json5". See more examples here.

 Features

- Edit videos with code! 🤓
- Declarative API with fun defaults
- Create colorful videos with random colors generated from aesthetically pleasing palettes and random effects
- Supports any input size, e.g. 4K video and DSLR photos
- Can output to any dimensions and aspect ratio, e.g. _Instagram post_ (1:1), _Instagram story_ (9:16), _YouTube_ (16:9), or any other dimensions you like.
- Content is scaled and letterboxed automatically, even if the input aspect ratio is not the same and the framerate will be converted.
- Speed up / slow down videos automatically to match the cutFrom/cutTo segment length with each clip's duration
- Overlay text and subtitles on videos, images or backgrounds
- Accepts custom HTML5 Canvas / Fabric.js JavaScript code for custom screens or dynamic overlays
- Render custom GL shaders (for example from shadertoy)
- Can output GIF
- Overlay transparent images or even videos with alpha channel
- Show different sub-clips for parts of a clips duration (B-roll)
- Picture-in-picture
- Vignette
- Preserve/mix multiple audio sources
- Automatic audio crossfading
- Automatic audio ducking and normalization

 Use cases

- Create a slideshow from a set of pictures with text overlay
- Create a fast-paced trailer or promo video
- Create a tutorial video with help text
- Create news stories
- Create an animated GIF
- Resize video to any size or framerate and with automatic letterboxing/cropping (e.g. if you need to upload a video somewhere but the site complains Video must be 1337x1000 30fps)
- Create a podcast with multiple mixed tracks

See examples

 Requirements

- Windows, MacOS or Linux
- Node.js installed (Use of the latest LTS version is recommended, v12.16.2 or newer on MacOS.)
- ffmpeg (and ffprobe) installed and available in PATH
- (Linux) may require some extra steps. See headless-gl.
- Editly is now ESM only

 Installing

npm i -g editly

 Usage: Command line video editor

Run editly --help for usage

Create a simple randomized video edit from videos, images and text with an audio track:

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


Or cre

Top issues

Discussions

Latest release

v0.15.0-rc.1 v0.15.0-rc.1 2025-01-19
📢  After a couple years of inactivity, editly now has a new maintainer and a new release (candidate). 


npm install editly@next


 Breaking Changes

 Node 18 is now required.
 Upgrade to Fabric 6 by @bkeepers in https://github.com/mifi/editly/pull/306 - If you are using custom fabric layers, you may need to update your code.

 New Features

 Adding fabricImagePostProcessing callback by @Ivanca in https://github.com/mifi/editly/pull/222 and https://github.com/mifi/editly/pull/227
 add right/left parameters - translations by @Kalo0m in https://github.com/mifi/editly/pull/238 and h

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON