<p align="center"><img src="https://auto-editor.com/img/auto-editor-banner.webp" title="Auto-Editor" width="700"></p>
**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
```
<h2 align="center">Installing</h2>
```
pip install auto-editor
```
See [Installing](https://auto-editor.com/installing) for additional information.
<h2 align="center">Cutting</h2>
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
```
<h2 align="center">Exporting to Editors</h2>
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 --silent-speed 1 --video-speed 1 --export premiere
```
<h2 align="center">Manual Editing</h2>
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
```
<h2 align="center">More Options</h2>
List all available options:
```
auto-editor --help
```
<h3 align="center">Auto-Editor is available on all major platforms</h3>
<p align="center"><img src="https://auto-editor.com/img/cross-platform.webp" width="500" title="Windows, MacOS, and Linux"></p>
## 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/)
## 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)
Raw data
{
"_id": null,
"home_page": null,
"name": "auto-editor",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "video, audio, media, editor, editing, processing, nonlinear, automatic, silence-detect, silence-removal, silence-speedup, motion-detection",
"author": null,
"author_email": "WyattBlue <wyattblue@auto-editor.com>",
"download_url": "https://files.pythonhosted.org/packages/fd/9f/53a0525e6dc5861d77b0d93c64ead0e17e5045e7ac96b40913841f1ddffa/auto_editor-29.0.5.tar.gz",
"platform": null,
"description": "<p align=\"center\"><img src=\"https://auto-editor.com/img/auto-editor-banner.webp\" title=\"Auto-Editor\" width=\"700\"></p>\n\n**Auto-Editor** is a command line application for automatically **editing video and audio** by analyzing a variety of methods, most notably audio loudness.\n\n---\n\n[](https://github.com/wyattblue/auto-editor/actions)\n\n\nBefore 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.\n\n```\nauto-editor path/to/your/video.mp4\n```\n\n<h2 align=\"center\">Installing</h2>\n\n```\npip install auto-editor\n```\n\nSee [Installing](https://auto-editor.com/installing) for additional information.\n\n\n<h2 align=\"center\">Cutting</h2>\n\nChange the **pace** of the edited video by using `--margin`.\n\n`--margin` adds in some \"silent\" sections to make the editing feel nicer.\n\n```\n# Add 0.2 seconds of padding before and after to make the edit nicer.\n# `0.2s` is the default value for `--margin`\nauto-editor example.mp4 --margin 0.2sec\n\n# Add 0.3 seconds of padding before, 1.5 seconds after\nauto-editor example.mp4 --margin 0.3s,1.5sec\n```\n\n### Methods for Making Automatic Cuts\nThe `--edit` option is how auto-editor makes automated cuts.\n\nFor example, edit out motionlessness in a video by setting `--edit motion`.\n\n```\n# cut out sections where the total motion is less than 2%.\nauto-editor example.mp4 --edit motion:threshold=0.02\n\n# `--edit audio:threshold=0.04,stream=all` is used by defaut.\nauto-editor example.mp4\n\n# Different tracks can be set with different attribute.\nauto-editor multi-track.mov --edit \"(or audio:stream=0 audio:threshold=10%,stream=1)\"\n```\n\nDifferent editing methods can be used together.\n```\n# 'threshold' is always the first argument for edit-method objects\nauto-editor example.mp4 --edit \"(or audio:0.03 motion:0.06)\"\n```\n\nYou can also use `dB` unit, a volume unit familiar to video-editors (case sensitive):\n```\nauto-editor example.mp4 --edit audio:-19dB\nauto-editor example.mp4 --edit audio:-7dB\nauto-editor example.mp4 --edit motion:-19dB\n```\n\n### See What Auto-Editor Cuts Out\nTo 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. \n\n```\nauto-editor example.mp4 --video-speed 99999 --silent-speed 1\n```\n\n<h2 align=\"center\">Exporting to Editors</h2>\n\nCreate an XML file that can be imported to Adobe Premiere Pro using this command:\n\n```\nauto-editor example.mp4 --export premiere\n```\n\nAuto-Editor can also export to:\n- DaVinci Resolve with `--export resolve`\n- Final Cut Pro with `--export final-cut-pro`\n- ShotCut with `--export shotcut`\n- Kdenlive with `--export kdenlive`\n- Individual media clips with `--export clip-sequence`\n\n### Naming Timelines\nSome 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.\n\n```\n# for POSIX shells\nauto-editor example.mp4 --export 'premiere:name=\"Your name here\"'\n\n# for Powershell\nauto-editor example.mp4 --export 'premiere:name=\"\"Your name here\"\"'\n```\n\n### Split by Clip\n\nIf you want to split the clips, but don't want auto-editor to do any more editing. There's a simple command.\n```\nauto-editor example.mp4 --silent-speed 1 --video-speed 1 --export premiere\n```\n\n<h2 align=\"center\">Manual Editing</h2>\n\nUse the `--cut-out` option to always remove a section.\n\n```\n# Cut out the first 30 seconds.\nauto-editor example.mp4 --cut-out 0,30sec\n\n# Cut out the first 30 frames.\nauto-editor example.mp4 --cut-out 0,30\n\n# Always leave in the first 30 seconds.\nauto-editor example.mp4 --add-in 0,30sec\n\n# Cut out the last 10 seconds.\nauto-editor example.mp4 --cut-out -10sec,end\n\n# You can do multiple at once.\nauto-editor example.mp4 --cut-out 0,10 15sec,20sec\nauto-editor example.mp4 --add-in 30sec,40sec 120,150sec\n```\n\nAnd of course, you can use any `--edit` configuration.\n\nIf you don't want **any automatic cuts**, you can use `--edit none` or `--edit all/e`\n\n```\n# Cut out the first 5 seconds, leave the rest untouched.\nauto-editor example.mp4 --edit none --cut-out 0,5sec\n\n# Leave in the first 5 seconds, cut everything else out.\nauto-editor example.mp4 --edit all/e --add-in 0,5sec\n```\n\n<h2 align=\"center\">More Options</h2>\n\nList all available options:\n\n```\nauto-editor --help\n```\n\n<h3 align=\"center\">Auto-Editor is available on all major platforms</h3>\n<p align=\"center\"><img src=\"https://auto-editor.com/img/cross-platform.webp\" width=\"500\" title=\"Windows, MacOS, and Linux\"></p>\n\n## Articles\n - [How to Install Auto-Editor](https://auto-editor.com/installing)\n - [All the Options (And What They Do)](https://auto-editor.com/ref/options)\n - [Docs](https://auto-editor.com/docs)\n - [Blog](https://basswood-io.com/blog/)\n\n## Copyright\nAuto-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)\n",
"bugtrack_url": null,
"license": null,
"summary": "Auto-Editor: Effort free video editing!",
"version": "29.0.5",
"project_urls": {
"Bug Tracker": "https://github.com/WyattBlue/auto-editor/discussions",
"Source Code": "https://github.com/WyattBlue/auto-editor",
"homepage": "https://auto-editor.com"
},
"split_keywords": [
"video",
" audio",
" media",
" editor",
" editing",
" processing",
" nonlinear",
" automatic",
" silence-detect",
" silence-removal",
" silence-speedup",
" motion-detection"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "13145e3ef4924bbd2199b1389758409e7b98c24b1978a24b9f94cccf8ddd6ba9",
"md5": "ae9ca64f1164eec1d6cfa09b235b760c",
"sha256": "1925ea33ac6ded5607d67b28793bf06cc1ef8c5c0cda096b32baf30a139a8994"
},
"downloads": -1,
"filename": "auto_editor-29.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ae9ca64f1164eec1d6cfa09b235b760c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 5873,
"upload_time": "2025-08-31T23:32:57",
"upload_time_iso_8601": "2025-08-31T23:32:57.799208Z",
"url": "https://files.pythonhosted.org/packages/13/14/5e3ef4924bbd2199b1389758409e7b98c24b1978a24b9f94cccf8ddd6ba9/auto_editor-29.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fd9f53a0525e6dc5861d77b0d93c64ead0e17e5045e7ac96b40913841f1ddffa",
"md5": "1a93a734e4bd5008724dbcd798632943",
"sha256": "a307016491f592c6579ab04aff7a70bd98df49005c733ced3b904b2e8fc13618"
},
"downloads": -1,
"filename": "auto_editor-29.0.5.tar.gz",
"has_sig": false,
"md5_digest": "1a93a734e4bd5008724dbcd798632943",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 10733,
"upload_time": "2025-08-31T23:32:59",
"upload_time_iso_8601": "2025-08-31T23:32:59.088028Z",
"url": "https://files.pythonhosted.org/packages/fd/9f/53a0525e6dc5861d77b0d93c64ead0e17e5045e7ac96b40913841f1ddffa/auto_editor-29.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-31 23:32:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "WyattBlue",
"github_project": "auto-editor",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "auto-editor"
}
JSON
