{"id":15039254,"url":"https://github.com/wyattblue/auto-editor","last_synced_at":"2026-04-13T08:01:30.170Z","repository":{"id":37417360,"uuid":"260117248","full_name":"WyattBlue/auto-editor","owner":"WyattBlue","description":"Auto-Editor: Efficient media analysis and rendering","archived":false,"fork":false,"pushed_at":"2025-03-20T19:23:47.000Z","size":118324,"stargazers_count":3209,"open_issues_count":0,"forks_count":447,"subscribers_count":43,"default_branch":"master","last_synced_at":"2025-04-08T22:05:46.712Z","etag":null,"topics":["audio","audio-editing","audio-processing","automatic","python3","video","video-editing","video-processing"],"latest_commit_sha":null,"homepage":"https://auto-editor.com","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WyattBlue.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-30T04:57:21.000Z","updated_at":"2025-04-08T21:20:11.000Z","dependencies_parsed_at":"2024-04-12T02:47:01.378Z","dependency_job_id":"9da1d775-8a7a-4039-9ab9-bf0244a4f3b5","html_url":"https://github.com/WyattBlue/auto-editor","commit_stats":{"total_commits":1133,"total_committers":14,"mean_commits":80.92857142857143,"dds":"0.39717563989408644","last_synced_commit":"57d8e55ef107655d37408e2656ca56733c0647b9"},"previous_names":[],"tags_count":109,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WyattBlue%2Fauto-editor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WyattBlue%2Fauto-editor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WyattBlue%2Fauto-editor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WyattBlue%2Fauto-editor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WyattBlue","download_url":"https://codeload.github.com/WyattBlue/auto-editor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247934828,"owners_count":21020728,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","audio-editing","audio-processing","automatic","python3","video","video-editing","video-processing"],"created_at":"2024-09-24T20:42:06.439Z","updated_at":"2026-04-01T22:28:18.867Z","avatar_url":"https://github.com/WyattBlue.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://auto-editor.com/img/auto-editor-banner.webp\" title=\"Auto-Editor\" width=\"700\"\u003e\u003c/p\u003e\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[![Actions Status](https://img.shields.io/github/actions/workflow/status/wyattblue/auto-editor/build.yml?style=flat)](https://github.com/wyattblue/auto-editor/actions)\n[![Nim](https://img.shields.io/badge/nim-%23FFE953.svg?style=flat\u0026logo=nim\u0026logoColor=black)](https://nim-lang.org)\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\u003ch2 align=\"center\"\u003eInstalling\u003c/h2\u003e\n\nSee [Installing](https://auto-editor.com/installing) for more information.\n\n\n\u003ch2 align=\"center\"\u003eCutting\u003c/h2\u003e\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 `--when-normal` to `cut` and `--when-silent` to `nil` (leave as is). This is the reverse of the usual default values.\n\n```\nauto-editor example.mp4 --when-normal cut --when-silent nil\n```\n\n\u003ch2 align=\"center\"\u003eExporting to Editors\u003c/h2\u003e\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 --when-silent nil --when-normal nil --export premiere\n```\n\n\u003ch2 align=\"center\"\u003eImporting timeline files\u003c/h2\u003e\nAuto-Editor can read fcp7 xml files and render them as media files:\n\n```\nauto-editor myFcp7File.xml -o render.mp4\n```\n\nAvailable Importers:\n - Auto-Editor timeline files (`.v1`, `.v2`, `.v3`)\n - FCP7 XML (experimental)\n\nPRs implementing more importers are encouraged.\n\n\u003ch2 align=\"center\"\u003eManual Editing\u003c/h2\u003e\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`\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 --add-in 0,5sec\n```\n\n\u003ch2 align=\"center\"\u003eMore Options\u003c/h2\u003e\n\nList all available options:\n\n```\nauto-editor --help\n```\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## GUI Application\nThere is a graphical application [available](https://app.auto-editor.com) under a propriety license. No GUI code, or proprietary code/assets, are included in this repository.\n\n## Copyright\nEverything in this repository is under the [Public Domain](https://github.com/WyattBlue/auto-editor/blob/master/LICENSE). Binary artifacts in the \"Releases\" section may be under various open source licenses.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwyattblue%2Fauto-editor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwyattblue%2Fauto-editor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwyattblue%2Fauto-editor/lists"}