<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)
<a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
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 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 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:3% motion:6%)"
```
You can also use `dB` unit, a volume unit familiar to video-editors (case sensitive):
```
auto-editor example.mp4 --edit audio:threshold=-19dB
auto-editor example.mp4 --edit audio:-7dB
auto-editor example.mp4 --edit motion:-19dB
# The `dB` unit is a just a macro that expands into an S-expression:
# '-19dB
# > '(pow 10 (/ -19 20))
# (eval '(pow 10 (/ -19 20)))
# > 0.11220184543019636
```
### Working With Multiple Audio Tracks
By default, only the first audio track will used for editing (track 0). You can change this with these commands.
Use all audio tracks for editing:
```
auto-editor multi-track.mov --edit audio:stream=all
```
Use only the second, fourth, and sixth audio track:
```
# track numbers start at 0
auto-editor so-many-tracks.mp4 --edit "(or audio:stream=1 audio:stream=3 audio:stream=5)"
```
### 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`
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.
### Naming Timelines
By default, auto-editor will name the timeline to "Auto-Editor Media Group" if the export supports naming.
```
auto-editor example.mp4 --export 'premiere:name="Your name here"'
auto-editor example.mp4 --export 'resolve:name="Your name here"'
auto-editor example.mp4 --export 'final-cut-pro:name="Your name here"'
# No other export options support naming
```
### 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
```
Use `--help` with a specific option for more information:
```
auto-editor --scale --help
--scale NUM
default: 1.0
Scale the output video's resolution by NUM factor
```
<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/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)
ae-ffmpeg is under the [LGPLv3 License](https://github.com/WyattBlue/auto-editor/blob/master/ae-ffmpeg/LICENSE.txt). The ffmpeg and ffprobe programs were created by the FFmpeg team.
Raw data
{
"_id": null,
"home_page": null,
"name": "auto-editor",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"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/7c/6f/f4e1732d3803c2b8ebe7edcb47a96006fd0bd78c33fbd8161222677d6b7e/auto-editor-24.13.1.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<a href=\"https://github.com/psf/black\"><img alt=\"Code style: black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"></a>\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 percentage of motion is less than 2.\nauto-editor example.mp4 --edit motion:threshold=2%\n\n# --edit is set to \"audio:threshold=4%\" by default.\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:3% motion:6%)\"\n```\n\nYou can also use `dB` unit, a volume unit familiar to video-editors (case sensitive):\n```\nauto-editor example.mp4 --edit audio:threshold=-19dB\nauto-editor example.mp4 --edit audio:-7dB\nauto-editor example.mp4 --edit motion:-19dB\n\n# The `dB` unit is a just a macro that expands into an S-expression:\n# '-19dB\n# > '(pow 10 (/ -19 20))\n# (eval '(pow 10 (/ -19 20)))\n# > 0.11220184543019636\n```\n\n### Working With Multiple Audio Tracks\nBy default, only the first audio track will used for editing (track 0). You can change this with these commands.\n\nUse all audio tracks for editing:\n```\nauto-editor multi-track.mov --edit audio:stream=all\n```\n\nUse only the second, fourth, and sixth audio track:\n```\n# track numbers start at 0\nauto-editor so-many-tracks.mp4 --edit \"(or audio:stream=1 audio:stream=3 audio:stream=5)\"\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\n- DaVinci Resolve with `--export resolve`\n- Final Cut Pro with `--export final-cut-pro`\n- ShotCut with `--export shotcut`\n\nOther 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.\n\n### Naming Timelines\nBy default, auto-editor will name the timeline to \"Auto-Editor Media Group\" if the export supports naming.\n\n```\nauto-editor example.mp4 --export 'premiere:name=\"Your name here\"'\n\nauto-editor example.mp4 --export 'resolve:name=\"Your name here\"'\n\nauto-editor example.mp4 --export 'final-cut-pro:name=\"Your name here\"'\n\n# No other export options support naming\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\nUse `--help` with a specific option for more information:\n\n```\nauto-editor --scale --help\n --scale NUM\n\n default: 1.0\n Scale the output video's resolution by NUM factor\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/options)\n - [Docs](https://auto-editor.com/docs)\n - [Blog](https://auto-editor.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\nae-ffmpeg is under the [LGPLv3 License](https://github.com/WyattBlue/auto-editor/blob/master/ae-ffmpeg/LICENSE.txt). The ffmpeg and ffprobe programs were created by the FFmpeg team.\n\n",
"bugtrack_url": null,
"license": "Unlicense",
"summary": "Auto-Editor: Effort free video editing!",
"version": "24.13.1",
"project_urls": {
"Bug Tracker": "https://github.com/WyattBlue/auto-editor/issues",
"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": "",
"digests": {
"blake2b_256": "2f7d44dd3d54f04c10dd01529ae4d408561106d5eafefbadcc572c4598e01cde",
"md5": "521d7c33e8fdaeba49df421926a79418",
"sha256": "1a59de0105bc2aecc1d21b7a9d6f598fda10d0cc1f6ccff209cf83e12c8c2731"
},
"downloads": -1,
"filename": "auto_editor-24.13.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "521d7c33e8fdaeba49df421926a79418",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 104389,
"upload_time": "2024-04-02T02:38:20",
"upload_time_iso_8601": "2024-04-02T02:38:20.552442Z",
"url": "https://files.pythonhosted.org/packages/2f/7d/44dd3d54f04c10dd01529ae4d408561106d5eafefbadcc572c4598e01cde/auto_editor-24.13.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7c6ff4e1732d3803c2b8ebe7edcb47a96006fd0bd78c33fbd8161222677d6b7e",
"md5": "beb740658179cb3c7417b53732c4a5c9",
"sha256": "7a240bba4dc3f852909af0bf728399011cc3e834d9247ee0b6159205eebe7ad2"
},
"downloads": -1,
"filename": "auto-editor-24.13.1.tar.gz",
"has_sig": false,
"md5_digest": "beb740658179cb3c7417b53732c4a5c9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 89765,
"upload_time": "2024-04-02T02:38:23",
"upload_time_iso_8601": "2024-04-02T02:38:23.200260Z",
"url": "https://files.pythonhosted.org/packages/7c/6f/f4e1732d3803c2b8ebe7edcb47a96006fd0bd78c33fbd8161222677d6b7e/auto-editor-24.13.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-02 02:38:23",
"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
