Our take
- 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.
Stars
5,616Forks
391Change 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.