# mifi/editly

Slick, declarative command line video editing & API

Repository: https://github.com/mifi/editly
Canonical: https://ross.abutalabs.com/products/editly
Language: TypeScript
License: MIT
License Family: permissive
Topics: video-editor, opengl, ffmpeg, cli, command-line, transition, animations, video, editor, slideshow, subtitle, images, clips
Last push: 2025-05-12T07:03:44+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 21, release rhythm 8, longevity 100
- inputs: {"age_days": 2331, "days_push": 478, "days_rel": 591, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5477, forks 371 (observed 2026-08-28T04:09:19.670661+00:00)

## What it is
Editly is a declarative non-linear video editing tool and framework built on Node.js and ffmpeg, offering both a CLI and a JavaScript API. It programmatically assembles videos from clips, images, audio, and titles with transitions, overlays, and effects using streaming for speed and low storage.

## Use cases
- create a slideshow from photos with text overlays
- programmatically render a promo or trailer video from clips
- resize and letterbox a video to a required resolution and framerate
- generate an animated GIF from video clips
- overlay subtitles or titles onto videos via a JSON spec
- apply custom GL shaders or Canvas-based dynamic effects to video

## When to choose
- you want to automate video creation in scripts or CI rather than a GUI editor
- you need declarative, reproducible video edits from a spec file
- you want fast streaming edits without huge intermediate files
- you need flexible output sizes like Instagram or YouTube aspect ratios

## When to avoid
- you need interactive timeline-based manual editing with a visual GUI
- you need advanced professional NLE features like multi-track color grading
- your project does not use Node.js and you cannot install ffmpeg

## Facets
- artifact type: cli-tool
- maturity: active
- function: video-processing, cli, animation, image-processing, audio-processing
- domain: media, developer-tools
- platform: cli, cross-platform
- tags: video-editing, ffmpeg, declarative, slideshow, transitions, subtitles, opengl-shaders, nle, video, automation, nodejs

## Member repositories
- mifi/editly (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:19.670661+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:56:42.443521+00:00, confidence not recorded.
  - readme: https://github.com/mifi/editly (fetched 2026-08-28T04:09:19.670661+00:00, sha fd9ebd4403fb)
  - registry_npm: https://registry.npmjs.org/editly (fetched 2026-08-29T08:51:50.656382+00:00, sha d00371617ac9)
- Data as of 2026-08-30T08:39:29.467469+00:00.