Skip to main content

Auto-Editor: Effort free video editing!

Project description

Auto-Editor is a command line application for automatically editing video and audio by analyzing a variety of methods, most notably audio loudness.

Actions Status Code style: black

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


pip install auto-editor

See Installing for additional information.


Change the pace of the edited video by using --margin.

--margin adds in some "silent" sections to make the editing feel nicer. Setting --margin to 0.2sec will add up to 0.2 seconds in front of and 0.2 seconds behind the original clip.

auto-editor example.mp4 --margin 0.2sec

Set how cuts are made

Use the --edit option to change how auto-editor makes automated cuts.

For example, edit out motionlessness in a video by setting --edit motion.

# cut out sections where percentage of motion is less than 2.
auto-editor example.mp4 --edit motion:threshold=2%

# --edit is set to "audio:threshold=4%" by default.
auto-editor example.mp4

# Different tracks can be set with different attribute.
auto-editor --edit 'audio:stream=0 or audio:threshold=10%,stream=1'

# Different editing methods can be used together.
auto-editor example.mp4 --edit 'audio:threshold=3% or motion:threshold=6%'

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:

  • Final Cut Pro with --export final-cut-pro
  • ShotCut with --export shotcut

Other editors, like Sony Vegas, can understand the premiere format. If your favorite editor doesn't, you can use --export clip-sequence which creates many video clips that can be imported and manipulated like normal.

Manual Editing

Use the --cut-out option to always remove a section.

# Cut out the first 10 seconds.
auto-editor example.mp4 --cut-out start,10sec

# Cut out the first 10 frames.
auto-editor example.mp4 --cut-out start,10

# Cut out the last 10 seconds.
auto-editor example.mp4 --cut-out -10sec,end

# Cut out the first 10 seconds and cut out the range from 15 seconds to 20 seconds.
auto-editor example.mp4 --cut-out start,10sec 15sec,20sec

And of course, all the audio cuts still apply.

If you don't want any automatic cuts, use --edit none

# Cut out the first 5 seconds, leave the rest untouched.
auto-editor example.mp4 --edit none --cut-out start,5sec

# Leave in the first 5 seconds, cut everything else out.
auto-editor example.mp4 --edit all --add-in start,5sec

More Options

List all available options:

auto-editor --help

Use --help with a specific option for more information:

auto-editor --scale --help

  type: number
  default: 1.0

  Scale the input video's resolution by the given factor.

Auto-Editor is available on all platforms



Auto-Editor is under the Public Domain and includes all directories besides the ones listed below. Auto-Editor was created by these people.

ae-ffmpeg is under the LGPLv3 License. The FFmpeg and FFprobe programs were created by the FFmpeg team and purposely compiled by WyattBlue for use in auto-editor.


If you encounter a bug or have a feature request, you can create a new issue. If you'll like to discuss this project, and chat with other users, you can use the discord server.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

auto-editor-22.32.1.tar.gz (65.0 kB view hashes)

Uploaded source

Built Distribution

auto_editor-22.32.1-py3-none-any.whl (77.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page