mifi

editly: Create Videos from Code and Media Clips

Editly is a Node.js command-line tool and JavaScript API for assembling videos from clips, images, titles, and audio. It suits creators and developers who want repeatable edits defined in code, with transitions and overlays rendered through ffmpeg.

TypeScriptMITCLIVideoAutomation
View on GitHub Compare
Stars
5.5k
Forks
379
Stars, last 30 days
+90

Our take

Health score

29/100

How it is scored
Activity
19
Community
54
Issues
21
Pull requests
20

+90 stars in the last 30 days

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

5,616

Forks

391

Change since Nov 16, 2026: +3 stars·+1 forks

Overview

Editly turns a declarative edit specification into a finished video. Instead of arranging every cut and overlay manually in a nonlinear editor, you describe clips, images, text, transitions, and audio in JSON or JavaScript, then render the result with ffmpeg.

It is most useful when edits need to be generated repeatedly or programmatically, such as producing slideshows, promos, or resized versions of existing footage. The project offers both a command-line workflow and a JavaScript API, with support for custom visual layers and shaders.

Key Features

  • Assemble sequential clips with configurable transitions and timing.
  • Layer video, images, titles, subtitles, and other visual content.
  • Mix audio from clips and separate tracks, with crossfades and normalization options.
  • Set output dimensions and frame rate, with automatic scaling and letterboxing or cropping.
  • Add dynamic content using Canvas, Fabric.js, or GLSL shader layers.
  • Render MP4 or GIF output through ffmpeg.

Use Cases

  • Developers can generate recurring promo or news videos from structured content and media assets.
  • Creators can turn batches of photos into narrated or music-backed slideshows.
  • Teams can add consistent titles, subtitles, and transitions to tutorial or podcast footage through reusable edit specifications.
  • Video producers can reformat footage to a required aspect ratio or resolution without rebuilding the edit manually.

Getting Started

Install the CLI with:

npm i -g editly

Node.js and ffmpeg, including ffprobe, must be installed and available in PATH. See the README for edit-spec examples, API details, and setup guidance.

Considerations

  • This is a code-driven editing tool, not a graphical timeline editor. It is better suited to scripted or repeatable compositions than hands-on frame-by-frame editing.
  • Rendering depends on external ffmpeg and ffprobe installations. Some Linux setups may also need dependencies for headless-gl.
  • Editly is ESM-only, which matters when integrating its JavaScript API into existing projects.
  • The README notes that remote media requests are disabled by default and must be explicitly allowed in the edit specification.

Found this useful?

Share it with someone who would like editly.

Comparisons