mifi /editly
Slick, declarative command line video editing & API
★ 5,613⑂ 390👁 59⑃ 103● 222▤ 26
More from this author
+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
#72Memory leak on long video (200 clips)31 comments · 2020-09-20#4Simple filtering12 comments · 2020-04-22#23Include ffmpeg11 comments · 2020-04-28#255Very slow video rendering8 comments · 2023-04-25#107[Feature Request] text/title.fontSize7 comments · 2021-01-04#49Duration changes with FPS7 comments · 2020-05-30#40got image file list ,audio file and srt file,how to write json57 comments · 2020-05-08#196Get Progress of Editly 6 comments · 2022-05-02
Discussions
#324Layers spanning multiple clips0 comments · 2025-04-04#308👋 New maintainer0 comments · 2025-01-17#285Merge the latest PRs2 comments · 2024-08-14#269mistake1 comments · 2023-09-08#263Cloud Function1 comments · 2023-06-12#262Is it possible to generate output files with multiple video tracks?0 comments · 2023-05-31#260Need Help To Make Audio Fade In At Beginning Of Video, Then Fade Out At The End.0 comments · 2023-05-21#248GIF question about duplicate frames1 comments · 2023-04-17
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