https://github.com/wyattblue/auto-editor
Auto-Editor: Efficient media analysis and rendering
https://github.com/wyattblue/auto-editor
audio audio-editing audio-processing automatic python3 video video-editing video-processing
Last synced: about 1 month ago
JSON representation
Auto-Editor: Efficient media analysis and rendering
- Host: GitHub
- URL: https://github.com/wyattblue/auto-editor
- Owner: WyattBlue
- License: unlicense
- Created: 2020-04-30T04:57:21.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-20T19:23:47.000Z (about 1 year ago)
- Last Synced: 2025-04-08T22:05:46.712Z (about 1 year ago)
- Topics: audio, audio-editing, audio-processing, automatic, python3, video, video-editing, video-processing
- Language: Python
- Homepage: https://auto-editor.com
- Size: 113 MB
- Stars: 3,209
- Watchers: 43
- Forks: 447
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
**Auto-Editor** is a command line application for automatically **editing video and audio** by analyzing a variety of methods, most notably audio loudness.
---
[](https://github.com/wyattblue/auto-editor/actions)
[](https://nim-lang.org)
Before doing the real editing, you first cut out the "dead space" which is typically silence. This is known as a "first pass". Cutting these is a boring task, especially if the video is very long.
```
auto-editor path/to/your/video.mp4
```
Installing
See [Installing](https://auto-editor.com/installing) for more information.
Cutting
Change the **pace** of the edited video by using `--margin`.
`--margin` adds in some "silent" sections to make the editing feel nicer.
```
# Add 0.2 seconds of padding before and after to make the edit nicer.
# `0.2s` is the default value for `--margin`
auto-editor example.mp4 --margin 0.2sec
# Add 0.3 seconds of padding before, 1.5 seconds after
auto-editor example.mp4 --margin 0.3s,1.5sec
```
### Methods for Making Automatic Cuts
The `--edit` option is how auto-editor makes automated cuts.
For example, edit out motionlessness in a video by setting `--edit motion`.
```
# cut out sections where the total motion is less than 2%.
auto-editor example.mp4 --edit motion:threshold=0.02
# `--edit audio:threshold=0.04,stream=all` is used by defaut.
auto-editor example.mp4
# Different tracks can be set with different attribute.
auto-editor multi-track.mov --edit "(or audio:stream=0 audio:threshold=10%,stream=1)"
```
Different editing methods can be used together.
```
# 'threshold' is always the first argument for edit-method objects
auto-editor example.mp4 --edit "(or audio:0.03 motion:0.06)"
```
You can also use `dB` unit, a volume unit familiar to video-editors (case sensitive):
```
auto-editor example.mp4 --edit audio:-19dB
auto-editor example.mp4 --edit audio:-7dB
auto-editor example.mp4 --edit motion:-19dB
```
### See What Auto-Editor Cuts Out
To export what auto-editor normally cuts out. Set `--when-normal` to `cut` and `--when-silent` to `nil` (leave as is). This is the reverse of the usual default values.
```
auto-editor example.mp4 --when-normal cut --when-silent nil
```
Exporting to Editors
Create an XML file that can be imported to Adobe Premiere Pro using this command:
```
auto-editor example.mp4 --export premiere
```
Auto-Editor can also export to:
- DaVinci Resolve with `--export resolve`
- Final Cut Pro with `--export final-cut-pro`
- ShotCut with `--export shotcut`
- Kdenlive with `--export kdenlive`
- Individual media clips with `--export clip-sequence`
### Naming Timelines
Some editors support naming timelines. By default, auto-editor will use the name "Auto-Editor Media Group". For `premiere` `resolve` and `final-cut-pro` export options, you can change the name with the following syntax.
```
# for POSIX shells
auto-editor example.mp4 --export 'premiere:name="Your name here"'
# for Powershell
auto-editor example.mp4 --export 'premiere:name=""Your name here""'
```
### Split by Clip
If you want to split the clips, but don't want auto-editor to do any more editing. There's a simple command.
```
auto-editor example.mp4 --when-silent nil --when-normal nil --export premiere
```
Importing timeline files
Auto-Editor can read fcp7 xml files and render them as media files:
```
auto-editor myFcp7File.xml -o render.mp4
```
Available Importers:
- Auto-Editor timeline files (`.v1`, `.v2`, `.v3`)
- FCP7 XML (experimental)
PRs implementing more importers are encouraged.
Manual Editing
Use the `--cut-out` option to always remove a section.
```
# Cut out the first 30 seconds.
auto-editor example.mp4 --cut-out 0,30sec
# Cut out the first 30 frames.
auto-editor example.mp4 --cut-out 0,30
# Always leave in the first 30 seconds.
auto-editor example.mp4 --add-in 0,30sec
# Cut out the last 10 seconds.
auto-editor example.mp4 --cut-out -10sec,end
# You can do multiple at once.
auto-editor example.mp4 --cut-out 0,10 15sec,20sec
auto-editor example.mp4 --add-in 30sec,40sec 120,150sec
```
And of course, you can use any `--edit` configuration.
If you don't want **any automatic cuts**, you can use `--edit none` or `--edit all`
```
# Cut out the first 5 seconds, leave the rest untouched.
auto-editor example.mp4 --edit none --cut-out 0,5sec
# Leave in the first 5 seconds, cut everything else out.
auto-editor example.mp4 --edit all --add-in 0,5sec
```
More Options
List all available options:
```
auto-editor --help
```
## Articles
- [How to Install Auto-Editor](https://auto-editor.com/installing)
- [All the Options (And What They Do)](https://auto-editor.com/ref/options)
- [Docs](https://auto-editor.com/docs)
- [Blog](https://basswood-io.com/blog/)
## GUI Application
There is a graphical application [available](https://app.auto-editor.com) under a propriety license. No GUI code, or proprietary code/assets, are included in this repository.
## Copyright
Everything in this repository is under the [Public Domain](https://github.com/WyattBlue/auto-editor/blob/master/LICENSE). Binary artifacts in the "Releases" section may be under various open source licenses.