Making editing a breeze.

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

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


pip3 install auto-editor

See Installing for additional information.


Change the pace of a video by using --frame_margin.

--frame_margin will add small sections that are next to loud sections. A frame margin of 8 will add up to 8 frames before and 8 frames after.

auto-editor example.mp4 --frame_margin 8

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 --motion_threshold 2%

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

# audio and motion thresholds are toggled independently
auto-editor example.mp4 --edit audio_or_motion --silent_threshold 3% --motion_threshold 6%

Exporting to Editors

Create an XML file that can be imported to Adobe Premiere Pro using this command:

auto-editor example.mp4 --export_to_premiere

Similar flags exist also for:

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

And the inverse

# 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
    scale the output media file by a certain factor.

    type: float_type
    default: 1



Auto-Editor is under the Public Domain but uses dependencies with other licenses. See this page for more info.


If you have a bug or a code suggestion, you can create a new issue. If you'll like to discuss this project, suggest new features, or chat with other users, you can use the discord server.