{"id":13501308,"url":"https://github.com/WyattBlue/auto-editor","last_synced_at":"2025-03-29T08:32:24.923Z","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":3184,"open_issues_count":0,"forks_count":446,"subscribers_count":42,"default_branch":"master","last_synced_at":"2025-03-25T20:05:52.358Z","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-03-25T17:45:29.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":246162092,"owners_count":20733351,"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-07-31T22:01:32.599Z","updated_at":"2025-03-29T08:32:19.909Z","avatar_url":"https://github.com/WyattBlue.png","language":"Python","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://github.com/wyattblue/auto-editor/workflows/build/badge.svg)](https://github.com/wyattblue/auto-editor/actions)\n\u003ca href=\"https://github.com/psf/black\"\u003e\u003cimg alt=\"Code style: black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"\u003e\u003c/a\u003e\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\n```\npip install auto-editor\n```\n\nSee [Installing](https://auto-editor.com/installing) for additional 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 `--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\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- 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\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/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\u003ch2 align=\"center\"\u003eMore Options\u003c/h2\u003e\n\nList all available options:\n\n```\nauto-editor --help\n```\n\nUse `--help` with a specific option to learn more about it:\n\n```\nauto-editor -c:v --help\nauto-editor --margin --help\n```\n\n\u003ch3 align=\"center\"\u003eAuto-Editor is available on all major platforms\u003c/h3\u003e\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://auto-editor.com/img/cross-platform.webp\" width=\"500\" title=\"Windows, MacOS, and Linux\"\u003e\u003c/p\u003e\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","funding_links":[],"categories":["HarmonyOS","Nim","Python"],"sub_categories":["Windows Manager"],"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"}