mifi

Professional software vendor delivering innovative solutions on the Softono platform. Specialized in both open-source and proprietary software development.

Visit Website

Total Products

Software by mifi

Open Source

mifi/lossless-cut

<div align="center"> <a href="https://losslesscut.app/"><img src="src/renderer/src/icon.svg" width="120" alt="LosslessCut" /></a> LosslessCut The swiss army knife of lossless video/audio editing <img src="https://github.com/mifi/lossless-cut/workflows/Build/release/badge.svg" /> <a href="https://paypal.me/mifino/usd"><img src="https://img.shields.io/badge/Donate-PayPal-green.svg" /></a> <a href="https://github.com/mifi/lossless-cut#download"><img src="https://img.shields.io/github/v/release/mifi/lossless-cut" /></a> <a href="https://discord.gg/fhnEREfUJ3"><img src="https://img.shields.io/discord/986051448385183804" /></a> <a href="https://twitter.com/losslesscut"><img src="https://img.shields.io/twitter/follow/losslesscut?label=Twitter&style=social" alt="Twitter"></a> <a href="https://mifi.no/thanks/">Thanks to my supporters</a> and everyone who purchased LosslessCut! <img src="main_screenshot.jpg" width="600" alt="screenshot" /> </div> LosslessCut aims to be the ultimate cross platform FFmpeg GUI for extremely fast and lossless operations on video, audio, subtitle and other related media files. The main feature is lossless trimming and cutting of video and audio files, which is great for saving space by rough-cutting your large video files taken from a video camera, GoPro, drone, etc. It lets you quickly extract the good parts from your videos and discard many gigabytes of data without doing a slow re-encode and thereby losing quality. There are also many more [use cases](#typical-workflow). Everything is extremely fast because it does an almost direct data copy, fueled by the awesome FFmpeg which does all the grunt work. ## Table of contents - [Features](#features) - [Example lossless use cases](#example-lossless-use-cases) - [Download](#download) - [Supported formats](#supported-formats) - [Documentation, usage & getting started](#documentation) - [Video demos](#video-demos) - [Featured](#featured) - [Attributions](#attributions) ## Features - Lossless cutting of most video and audio formats - [Smart cut](https://github.com/mifi/lossless-cut/issues/126) (experimental) - Losslessly cut out parts of video/audio (for cutting away commercials etc.) - Losslessly rearrange the order of video/audio segments - Lossless merge/concatenation of arbitrary files (with identical codecs parameters, e.g. from the same camera) - Lossless multi track/stream editing - Combine arbitrary tracks from multiple files (ex. add music or subtitle track to a video file) - Remove unneeded tracks - Replace or re-encode only some tracks - Extract all tracks from a file (extract video, audio, subtitle, attachments and other tracks from one file into separate files) - View technical data about all tracks. Edit file metadata, per-track metadata and per-track disposition - Select video/audio tracks for playback. Playback multiple audio tracks simultaneously. - Fast multi-file workflow (note: no mass/batch export yet) - Keyboard shortcut workflow - Losslessly remux video/audio into a different container (file) format - Take full-resolution snapshots from videos in JPEG/PNG format (low or high quality) - Export ranges of video frames to images (every nth frame, second, by scene change, best thumbnails) - Export only from a selected time range (segment) - Optionally include original timestamps in image file names - Manual input of cutpoint times - Apply a per-file timecode offset (and auto load timecode from file) - Change rotation/orientation metadata in videos - Timeline zoom and frame/keyframe jumping for cutting around keyframes - Video thumbnails and audio waveform - Saves per project cut segments to project file - View FFmpeg last command log so you can modify and re-run recent commands on the command line - Undo/redo - Advanced segment query and mutation JS-based expression language. - Give labels to cut segments, annotate with tags - [Import/export](docs/index.md#importexport-projects) segments: MP4/MKV chapter marks, Text file, YouTube, CSV, CUE, XML (DaVinci, Final Cut Pro) and more - MKV/MP4 embedded chapters marks editor - View subtitles - Customizable keyboard hotkeys - Black scene detection, silent audio detection, and scene change detection - Divide timeline into segments of length L, size (X MB), N number of segments or even randomized segments! - Speed up / slow down video or audio file ([changing FPS](https://github.com/mifi/lossless-cut/issues/1712)) - Lossless crop and aspect ratio modification - Basic [CLI](docs/cli.md) and [HTTP API](docs/api.md) - Show (DJI) embedded GPS track on a map - Losslessly Download videos over HTTP (e.g. HLS `.m3u8`) - Extremely fast removal of all non-keyframes (e.g. timelapse) ## Example lossless use cases - Cut out commercials from a recorded TV show (and re-format from TS to MP4). - Remove audio tracks from a file. - Extract music track from a video and cut it to your needs. - Add music to a video (or replace existing audio track). - Combine audio and video tracks from separate recordings. - Include an external subtitle into a video - Quickly change a H264/H265 MKV video to MOV or MP4 for playback on iPhone. - Import a list of cut times from other tool as a EDL (edit decision list, CSV) and run these cuts with LosslessCut. - Export a list of cut times as a CSV EDL and process these in another tool. - Quickly cut a file by its MP4/MKV chapters. - Quickly cut a [YouTube video](https://youtube-dl.org/) by its chapters (or music times from a comment). - Change the language of a file's audio/subtitle tracks. - Attach cover art / thumbnail to videos / audio from an external JPEG file or from a frame on the timeline. - Change author, title, GPS position, recording time of a video. - Fix rotation of a video that has the wrong orientation flag set. - Loop a video / audio clip X times quickly without re-encoding, see [#284](https://github.com/mifi/lossless-cut/issues/284). - Convert a video or parts of it into X image files (not lossless) - Losslessly split a video into one file per scene (note you probably have to shift segments, see [#330](https://github.com/mifi/lossless-cut/issues/330).) - Cut away silent parts from an audio/video file. - Split video into segments to for example respect Twitter's 140 second limit. - Annotate each segment with one or more tags, then use those tags to organize your segments or use it to create an output folder structure or hierarchy for your segments. See also [Recipe cookbook](docs/recipes.md) ## Download If you want to support my continued work on LosslessCut, and you want the advantage of a secure and simple installation process with automatic, stable updates, consider getting it from your favorite store: <a href="https://apps.apple.com/app/id1505323402"><img src="mac-app-store-badge.svg" alt="Mac App Store" height="50"/></a> <a href="https://www.microsoft.com/store/apps/9P30LSR4705L?cid=storebadge&ocid=badge"><img src="ms-store-badge.svg" alt="MS badge" height="50"/></a> For Linux these are some alternatives: <a href="https://snapcraft.io/losslesscut"><img src="https://github.com/mifi/lossless-cut/raw/master/snap-store-black.svg?sanitize=true" alt="Snapcraft" height="50"/></a> <a href="https://flathub.org/apps/details/no.mifi.losslesscut"><img src="https://github.com/mifi/lossless-cut/raw/master/flathub-badge.svg?sanitize=true" alt="Flathub" height="50"/></a> If you prefer to download the executables manually, this will of course always be free (see also [supported operating systems](docs/requirements.md)): - macOS: [Intel](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-mac-x64.dmg) / [Apple Silicon](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-mac-arm64.dmg) DMG (note that PKG does **not** work) - Windows: [7zip](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-win-x64.7z) (Windows 7, 8 and 8.1 is [no longer supported after v3.50.0](docs/requirements.md)) - Linux: [x64 tar.bz2](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux-x64.tar.bz2) / [x64 AppImage](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux-x86_64.AppImage) / [arm64 tar.bz2](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux-arm64.tar.bz2) / [Raspberry Pi armv7l](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux-armv7l.tar.bz2) - [More releases](https://github.com/mifi/lossless-cut/releases) - Note that APPX (Windows) and PKG (macOS) do **not** work) - [Latest nightly builds 🧪](https://mifi.no/llc/nightly/) Difference between App Stores and GitHub download? [Please see FAQ](docs/index.md#faq). [![](./donate.svg)](https://mifi.no/thanks) LosslessCut is maintained by me alone and will always remain free and open source. If it's useful to you, consider supporting my work. Alternatively [donate to FFmpeg](https://www.ffmpeg.org/donations.html) because they are doing the world a huge favor. [Paypal](https://paypal.me/mifino/usd) | [crypto](https://mifi.no/thanks) | [more](https://mifi.no/thanks) ## Supported formats LosslessCut uses the Chromium browser's HTML5 video player, and not all formats/codecs are [natively supported](https://www.chromium.org/audio-video). Generally, the following file formats work: `MP4`, `MOV`, `WebM`, `Matroska`, `OGG` and `WAV`. Audio codecs: `FLAC`, `MP3`, `Opus`, `PCM`, `Vorbis` and `AAC`. Video codecs: `H264`, `AV1`, `Theora`, `VP8`, `VP9` and `H265` (with hardware decoder). Learn the [difference between a codec and a format](docs/index.md#primer-videoaudio-codecs-vs-formats). Codecs and formats not listed above can still be converted to a supported format/codec from the `File` menu (try the option *Fastest: FFmpeg-assisted playback* first). A low quality version of the file will then be created and opened in the player. Note that the actual cut/export operation will still be performed on the original file, so it will be lossless. This allows for potentially opening any file that FFmpeg is able to decode. ## Documentation - Official website: [LosslessCut.app](https://losslesscut.app) - **[Getting started, FAQ and usage documentation](docs/index.md)** - [Troubleshooting and known issues and limitations](docs/troubleshooting.md) - [Contributing](CONTRIBUTING.md) ### Video demos - [Common features](https://www.youtube.com/watch?v=pYHMxXy05Jg) - [How to add a thumbnail / cover art to an MP4](https://www.youtube.com/watch?v=4pYJ93cn80E) - [How to add multi-language audio to a video](https://www.youtube.com/watch?v=MRBGDsuw_WU) - Your video here? ## Featured - [Console newsletter](https://console.substack.com/p/console-93) - Hacker News [2024](https://news.ycombinator.com/item?id=40829494) [2022](https://news.ycombinator.com/item?id=33969490) [2020-10](https://news.ycombinator.com/item?id=24883030) [2020-01](https://news.ycombinator.com/item?id=22026412) [2016](https://news.ycombinator.com/item?id=12885585) - [Wikipedia](https://en.m.wikipedia.org/wiki/LosslessCut) - Your link here? - theo (YouTube) [1](https://youtu.be/FI5ba4RRE8U?t=246) [2](https://youtu.be/uaCypXEJjes?t=381) <img src="https://api.star-history.com/svg?repos=mifi/lossless-cut&type=Date" alt="Star History Chart" width="400px" /> ## Attributions - App icon made by [Dimi Kazak](http://www.flaticon.com/authors/dimi-kazak "Dimi Kazak") from [www.flaticon.com](http://www.flaticon.com "Flaticon") is licensed by [CC 3.0 BY](http://creativecommons.org/licenses/by/3.0/ "Creative Commons BY 3.0"). - [Lottie animation by Chris Gannon](https://lottiefiles.com/7077-magic-flow). - Thanks to Adi Abinun and [@abdul-alhasany](https://github.com/mifi/lossless-cut/issues/2561) for UI work. - Thanks to translators who helped translate the app. [You can too!](docs/translation.md) - [Thanks to everyone for supporting](https://mifi.no/thanks/) my open source work 🙌 --- Made with ❤️ in [🇳🇴](https://www.youtube.com/watch?v=uQIv8Vo9_Jc) [More apps by mifi.no](https://mifi.no/) Follow me on [GitHub](https://github.com/mifi/), [YouTube](https://www.youtube.com/channel/UC6XlvVH63g0H54HSJubURQA), [IG](https://www.instagram.com/mifi.no/), [Twitter](https://twitter.com/mifi_no) for more awesome content!

Video Editing Audio Editing & DAW

41.1K Github Stars

Open Source

editly

![](logo.png) [![Discord](https://img.shields.io/discord/986052452245700659)](https://discord.gg/P3u6zKbDK7) [![NPM version](https://img.shields.io/npm/v/editly.svg?style=flat-square)](https://npmjs.org/package/editly) ![Build status](https://github.com/mifi/editly/actions/workflows/test.yml/badge.svg) [![PayPal](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/mifino/usd) **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](https://github.com/transitive-bullshit/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**. [![demo](https://github.com/mifi/gifs/raw/master/commonFeatures.gif)](https://youtu.be/LNeclLkxUEY) This GIF / YouTube was created with this command: "editly [commonFeatures.json5](examples/commonFeatures.json5)". See [more examples here](https://github.com/mifi/editly/tree/master/examples#examples). ## 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](https://www.shadertoy.com/)) - 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](https://github.com/mifi/editly/tree/master/examples) ## Requirements - Windows, MacOS or Linux - [Node.js installed](https://nodejs.org/en/) (Use of the latest LTS version is recommended, [v12.16.2 or newer on MacOS](https://github.com/sindresorhus/meow/issues/144).) - `ffmpeg` (and `ffprobe`) [installed](http://ffmpeg.org/) and available in `PATH` - (Linux) may require some extra steps. See [headless-gl](https://github.com/stackgl/headless-gl#system-dependencies). - **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 create an MP4 (or GIF) from a JSON or JSON5 edit spec _(JSON5 is just a more user friendly JSON format)_: ```sh editly my-spec.json5 --fast --keep-source-audio --out output.gif ``` For examples of how to make a JSON edit spec, see below or [examples](https://github.com/mifi/editly/tree/master/examples). Without `--fast`, it will default to using the **width**, **height** and **frame rate** from the **first** input video. **All other clips will be converted to these dimensions.** You can of course override any or all of these parameters. - **TIP:** Use this tool in conjunction with [LosslessCut](https://github.com/mifi/lossless-cut) - **TIP:** If you need catchy music for your video, have a look at [this YouTube](https://www.youtube.com/channel/UCht8qITGkBvXKsR1Byln-wA) or the [YouTube audio library](https://www.youtube.com/audiolibrary/music?nv=1). Then use [youtube-dl](https://github.com/ytdl-org/youtube-dl) to download the video, and then point `--audio-file-path` at the video file. _Be sure to respect their license!_ ## JavaScript library ```js import editly from "editly"; // See editSpec documentation await editly(editSpec); ``` ## Edit spec Edit specs are JavaScript / JSON objects describing the whole edit operation with the following structure: ```js { outPath, width, height, fps, allowRemoteRequests: false, defaults: { duration: 4, transition: { duration: 0.5, name: 'random', audioOutCurve: 'tri', audioInCurve: 'tri', }, layer: { fontPath, // ...more layer defaults }, layerType: { 'fill-color': { color: '#ff6666', } // ...more per-layer-type defaults }, }, clips: [ { transition, duration, layers: [ { type, // ...more layer-specific options } // ...more layers ], } // ...more clips ], audioFilePath, loopAudio: false, keepSourceAudio: false, clipsAudioVolume: 1, outputVolume: 1, audioTracks: [ { path, mixVolume: 1, cutFrom: 0, cutTo, start: 0, }, // ...more audio tracks ], audioNorm: { enable: false, gaussSize: 5, maxGain: 30, } // Testing options: enableFfmpegLog: false, verbose: false, fast: false, } ``` ### Parameters | Parameter | CLI equivalent | Description | Default | | | ----------------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -------------------- | | `outPath` | `--out` | Output path (mp4, mkv), can also be a `.gif` | | | | `width` | `--width` | Width which all media will be converted to | `640` | | | `height` | `--height` | Height which all media will be converted to | auto based on `width` and aspect ratio of **first video** | | | `fps` | `--fps` | FPS which all videos will be converted to | First video FPS or `25` | | | `customOutputArgs` | | Specify custom output codec/format arguments for ffmpeg (See [example](https://github.com/mifi/editly/blob/master/examples/customOutputArgs.json5)) | auto (h264) | | | `allowRemoteRequests` | `--allow-remote-requests` | Allow remote URLs as paths | `false` | | | `fast` | `--fast`, `-f` | Fast mode (low resolution and FPS, useful for getting a quick preview ⏩) | `false` | | | `defaults.layer.fontPath` | `--font-path` | Set default font to a .ttf | System font | | | `defaults.layer.*` | | Set any layer parameter that all layers will inherit | | | | `defaults.duration` | `--clip-duration` | Set default clip duration for clips that don't have an own duration | `4` | sec | | `defaults.transition` | | An object `{ name, duration }` describing the default transition. Set to **null** to disable transitions | | | | `defaults.transition.duration` | `--transition-duration` | Default transition duration | `0.5` | sec | | `defaults.transition.name` | `--transition-name` | Default transition type. See [Transition types](#transition-types) | `random` | | | `defaults.transition.audioOutCurve` | | Default [fade out curve](https://trac.ffmpeg.org/wiki/AfadeCurves) in audio cross fades | `tri` | | | `defaults.transition.audioInCurve` | | Default [fade in curve](https://trac.ffmpeg.org/wiki/AfadeCurves) in audio cross fades | `tri` | | | `clips[]` | | List of clip objects that will be played in sequence. Each clip can have one or more layers. | | | | `clips[].duration` | | Clip duration. See `defaults.duration`. If unset, the clip duration will be that of the **first video layer**. | `defaults.duration` | | | `clips[].transition` | | Specify transition at the **end** of this clip. See `defaults.transition` | `defaults.transition` | | | `clips[].layers[]` | | List of layers within the current clip that will be overlaid in their natural order (final layer on top) | | | | `clips[].layers[].type` | | Layer type, see below | | | | `clips[].layers[].start` | | What time into the clip should this layer start | | sec | | `clips[].layers[].stop` | | What time into the clip should this layer stop | | sec | | `audioTracks[]` | | List of arbitrary audio tracks. See [audio tracks](#arbitrary-audio-tracks). | `[]` | | | `audioFilePath` | `--audio-file-path` | Set an audio track for the whole video. See also [audio tracks](#arbitrary-audio-tracks) | | | | `loopAudio` | `--loop-audio` | Loop the audio track if it is shorter than video? | `false` | | | `keepSourceAudio` | `--keep-source-audio` | Keep source audio from `clips`? | `false` | | | `clipsAudioVolume` | | Volume of audio from `clips` relative to `audioTracks`. See [audio tracks](#arbitrary-audio-tracks). | `1` | | | `outputVolume` | `--output-volume` | Adjust output [volume](http://ffmpeg.org/ffmpeg-filters.html#volume) (final stage). See [example](https://github.com/mifi/editly/blob/master/examples/audio-volume.json5) | `1` | e.g. `0.5` or `10dB` | | `audioNorm.enable` | | Enable audio normalization? See [audio normalization](#audio-normalization). | `false` | | | `audioNorm.gaussSize` | | Audio normalization gauss size. See [audio normalization](#audio-normalization). | `5` | | | `audioNorm.maxGain` | | Audio normalization max gain. See [audio normalization](#audio-normalization). | `30` | | ### Transition types `transition.name` can be any of [gl-transitions](https://gl-transitions.com/gallery), or any of the following: `directional-left`, `directional-right`, `directional-up`, `directional-down`, `random` or `dummy`. ### Layer types See [examples](https://github.com/mifi/editly/tree/master/examples) and [commonFeatures.json5](examples/commonFeatures.json5) #### Layer type 'video' For video layers, if parent `clip.duration` is specified, the video will be slowed/sped-up to match `clip.duration`. If `cutFrom`/`cutTo` is set, the resulting segment (`cutTo`-`cutFrom`) will be slowed/sped-up to fit `clip.duration`. If the layer has audio, it will be kept (and mixed with other audio layers if present.) | Parameter | Description | Default | | | ------------ | ---------------------------------------------------------------- | -------------- | ----------------- | | `path` | Path to video file | | | | `resizeMode` | See [Resize modes](#resize-modes) | | | | `cutFrom` | Time value to cut from | `0` | sec | | `cutTo` | Time value to cut to | _end of video_ | sec | | `width` | Width relative to screen width | `1` | `0` to `1` | | `height` | Height relative to screen height | `1` | `0` to `1` | | `left` | X-position relative to screen width | `0` | `0` to `1` | | `top` | Y-position relative to screen height | `0` | `0` to `1` | | `originX` | X anchor | `left` | `left` or `right` | | `originY` | Y anchor | `top` | `top` or `bottom` | | `mixVolume` | Relative volume when mixing this video's audio track with others | `1` | | #### Layer type 'audio' Audio layers will be mixed together. If `cutFrom`/`cutTo` is set, the resulting segment (`cutTo`-`cutFrom`) will be slowed/sped-up to fit `clip.duration`. The slow down/speed-up operation is limited to values between `0.5x` and `100x`. | Parameter | Description | Default | | | ----------- | -------------------------------------------------------- | --------------- | --- | | `path` | Path to audio file | | | | `cutFrom` | Time value to cut from | `0` | sec | | `cutTo` | Time value to cut to | `clip.duration` | sec | | `mixVolume` | Relative volume when mixing this audio track with others | `1` | | #### Layer type 'detached-audio' This is a special case of `audioTracks` that makes it easier to start the audio relative to `clips` start times without having to calculate global start times. `detached-audio` has the exact same properties as [audioTracks](#arbitrary-audio-tracks), except `start` time is relative to the clip's start. [Example of detached audio tracks](examples/audio3.json5) #### Layer type 'image' Full screen image | Parameter | Description | Default | | | ------------ | --------------------------------- | ------- | --- | | `path` | Path to image file | | | | `resizeMode` | See [Resize modes](#resize-modes) | | | See also See [Ken Burns parameters](#ken-burns-parameters). #### Layer type 'image-overlay' Image overlay with a custom position and size on the screen. NOTE: If you want to use animated GIFs use `video` instead. | Parameter | Description | Default | | | ---------- | --------------------------------------------- | ------- | --- | | `path` | Path to image file | | | | `position` | See [Position parameter](#position-parameter) | | | | `width` | Width (from 0 to 1) where 1 is screen width | | | | `height` | Height (from 0 to 1) where 1 is screen height | | | See also [Ken Burns parameters](#ken-burns-parameters). #### Layer type 'title' - `fontPath` - See `defaults.layer.fontPath` - `text` - Title text to show, keep it short - `textColor` - default `#ffffff` - `position` - See [Position parameter](#position-parameter) See also [Ken Burns parameters](#ken-burns-parameters) #### Layer type 'subtitle' - `fontPath` - See `defaults.layer.fontPath` - `text` - Subtitle text to show - `textColor` - default `#ffffff` #### Layer type 'title-background' Title with background - `text` - See type `title` - `textColor` - See type `title` - `background` - `{ type, ... }` - See type `radial-gradient`, `linear-gradient` or `fill-color` - `fontPath` - See type `title` #### Layer type 'news-title' - `fontPath` - See `defaults.layer.fontPath` - `text` - `textColor` - default `#ffffff` - `backgroundColor` - default `#d02a42` - `position` - See [Position parameter](#position-parameter) #### Layer type 'slide-in-text' - `fontPath` - See `defaults.layer.fontPath` - `text` - `fontSize` - `charSpacing` - `color` - `position` - See [Position parameter](#position-parameter) #### Layer type 'fill-color', 'pause' - `color` - Color to fill background, default: randomize #### Layer type 'radial-gradient' - `colors` - Array of two colors, default: randomize #### Layer type 'linear-gradient' - `colors` - Array of two colors, default: randomize #### Layer type 'rainbow-colors' 🌈🌈🌈 #### Layer type 'canvas' See [customCanvas.js](examples/customCanvas.js) - `func` - Custom JavaScript function #### Layer type 'fabric' See [customFabric.js](examples/customFabric.js) - `func` - Custom JavaScript function #### Layer type 'gl' Loads a GLSL shader. See [gl.json5](examples/gl.json5) and [rainbow-colors.frag](shaders/rainbow-colors.frag) - `fragmentPath` - `vertexPath` (optional) ### Arbitrary audio tracks `audioTracks` property can optionally contain a list of objects which specify audio tracks that can be started at arbitrary times in the final video. These tracks will be mixed together (`mixVolume` specifying a relative number for how loud each track is compared to the other tracks). Because audio from `clips` will be mixed separately from `audioTracks`, `clipsAudioVolume` specifies the volume of the **combined** audio from `clips` relative to the volume of **each of the audio tracks** from `audioTracks`. | Parameter | Description | Default | | | ------------------------- | ----------------------------------------------------- | ------- | --- | | `audioTracks[].path` | File path for this track | | | | `audioTracks[].mixVolume` | Relative volume for this track | `1` | | | `audioTracks[].cutFrom` | Time value to cut source file **from** | `0` | sec | | `audioTracks[].cutTo` | Time value to cut source file **to** | | sec | | `audioTracks[].start` | How many seconds into video to start this audio track | `0` | sec | The difference between `audioTracks` and **Layer type 'audio'** is that `audioTracks` will continue to play across multiple `clips` and can start and stop whenever needed. See `audioTracks` [example](examples/audio2.json5) See also **Layer type 'detached-audio'**. ### Audio normalization You can enable audio normalization of the final output audio. This is useful if you want to achieve Audio Ducking (e.g. automatically lower volume of all other tracks when voice-over speaks). `audioNorm` parameters are [documented here.](https://ffmpeg.org/ffmpeg-filters.html#dynaudnorm) [Example of audio ducking](examples/audio2.json5) ### Resize modes `resizeMode` - How to fit image to screen. Can be one of: - `contain` - All the video will be contained within the frame and letterboxed - `contain-blur` - Like `contain`, but with a blurred copy as the letterbox - `cover` - Video be cropped to cover the whole screen (aspect ratio preserved) - `stretch` - Video will be stretched to cover the whole screen (aspect ratio ignored). Default `contain-blur`. See: - [image.json5](examples/image.json5) - [videos.json5](examples/videos.json5) ### Position parameter Certain layers support the position parameter `position` can be one of either: - `top`, `bottom` `center`, `top-left`, `top-right`, `center-left`, `center-right`, `bottom-left`, `bottom-right` - An object `{ x, y, originX = 'left', originY = 'top' }`, where `{ x: 0, y: 0 }` is the upper left corner of the screen, and `{ x: 1, y: 1 }` is the lower right corner, `x` is relative to video width, `y` to video height. `originX` and `originY` are optional, and specify the position's origin (anchor position) of the object. See [position.json5](examples/position.json5) ### Ken Burns parameters | Parameter | Description | Default | | | --------------- | -------------------------------------------------------------------------------------- | ------- | --- | | `zoomDirection` | Zoom direction for Ken Burns effect: `in`, `out`, `left`, `right` or `null` to disable | | | | `zoomAmount` | Zoom amount for Ken Burns effect | `0.1` | | ## Docker This should help you use editly as a containerized CLI, without worrying about getting all the right versions of dependencies on your system. ```bash $ git clone https://github.com/mifi/editly.git $ cd editly/examples $ git clone https://github.com/mifi/editly-assets.git assets $ cd .. $ docker-compose up $ docker-compose run editly bash -c "cd examples && editly audio1.json5 --out /outputs/audio1.mp4" $ docker cp editly:/outputs/audio1.mp4 . ``` ## Troubleshooting - If you get `Error: The specified module could not be found.`, try: `npm un -g editly && npm i -g --build-from-source editly` (see [#15](https://github.com/mifi/editly/issues/15)) - If you get an error about gl returning null, see Requirements. - If you get an error `/bin/sh: pkg-config: command not found`, try to use newest Node.js LTS version ## Donate 🙏 This project is maintained by me alone. The project will always remain free and open source, but if it's useful for you, consider supporting me. :) It will give me extra motivation to improve it. [Paypal](https://paypal.me/mifino/usd) ## Thanks This package would not exist without the support and help from all the contributors and sponsors! **Special thanks to:** - [Patrick Connolly](https://github.com/patcon) - docker-compose support - [Skayo](https://github.com/Skayo) - Typescript support ## See also - https://github.com/mifi/reactive-video - React based alternative to editly - https://github.com/JonnyBurger/remotion - React based alternative to editly (not open source) - https://github.com/pankod/canvas2video - Similar project based on Cairo - https://github.com/h2non/videoshow - Inspired editly - https://github.com/transitive-bullshit/ffmpeg-concat - Inspired editly - http://www.quasimondo.com/BoxBlurForCanvas/FastBlurDemo.html - Fast blur effect used in editly - https://github.com/transitive-bullshit/awesome-ffmpeg - https://github.com/sjfricke/awesome-webgl - https://www.mltframework.org/docs/melt/ - Icon made by [Freepik](https://www.flaticon.com/authors/freepik) from [www.flaticon.com](https://www.flaticon.com/) ## Videos made by you Submit a PR if you want to share your videos or project created with editly here. - https://www.youtube.com/channel/UCDUauYxuY5Cv1Z6AuD3UGDw?view_as=subscriber --- Made with ❤️ in 🇳🇴 [More apps by mifi.no](https://mifi.no/) Follow me on [GitHub](https://github.com/mifi/), [YouTube](https://www.youtube.com/channel/UC6XlvVH63g0H54HSJubURQA), [IG](https://www.instagram.com/mifi.no/), [Twitter](https://twitter.com/mifi_no) for more awesome content!

Video Editing

5.4K Github Stars