Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 2 days 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 (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-29T06:41:38.000Z (about 2 months ago)
- Last Synced: 2024-10-02T01:41:35.610Z (about 2 months ago)
- Topics: audio, audio-editing, audio-processing, automatic, python3, video, video-editing, video-processing
- Language: Python
- Homepage: https://auto-editor.com
- Size: 112 MB
- Stars: 2,845
- Watchers: 38
- Forks: 416
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: changelogs/2022.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)
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
```
pip install auto-editor
```
See [Installing](https://auto-editor.com/installing) for additional 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 `--video-speed` to `99999` and `--silent-speed` to `1`. This is the reverse of the usual default values.
```
auto-editor example.mp4 --video-speed 99999 --silent-speed 1
```
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`
- 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 --silent-speed 1 --video-speed 1 --export premiere
```
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/e`
```
# 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/e --add-in 0,5sec
```
More Options
List all available options:
```
auto-editor --help
```
Use `--help` with a specific option to learn more about it:
```
auto-editor -c:v --help
auto-editor --margin --help
```
Auto-Editor is available on all major platforms
## Articles
- [How to Install Auto-Editor](https://auto-editor.com/installing)
- [All the Options (And What They Do)](https://auto-editor.com/options)
- [Docs](https://auto-editor.com/docs)
- [Blog](https://auto-editor.com/blog)
## Copyright
Auto-Editor is under the [Public Domain](https://github.com/WyattBlue/auto-editor/blob/master/LICENSE) and includes all directories besides the ones listed below. Auto-Editor was created by [these people.](https://auto-editor.com/blog/thank-you-early-testers)