How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/wyattblue/auto-editor --skill auto-editor-exportBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Exporting & importing
By default auto-editor renders a media file. --export (-ex) changes the target. The output extension is chosen automatically per mode.
auto-editor video.mp4 --export premiere # → video_ALTERED.xml for Premiere ProExport targets
--export | For | Output |
|---|---|---|
premiere | Adobe Premiere Pro (fcp7 xml) | .xml |
resolve | DaVinci Resolve (fcpxml) | .fcpxml |
resolve-fcp7 | Resolve via legacy fcp7 xml | .xml |
final-cut-pro | Final Cut Pro | .fcpxml |
shotcut | ShotCut | .mlt |
kdenlive | Kdenlive | .kdenlive |
clip-sequence | individual media clips, one per kept segment | media files |
v1 / v2 / v3 | auto-editor timeline files | .v1 / .v2 / .v3 |
| (default) | rendered media file | per container |
auto-editor video.mp4 --export resolve
auto-editor video.mp4 --export final-cut-pro
auto-editor video.mp4 --export clip-sequence
auto-editor video.mp4 --export v3 -o timeline.v3Export a microphone recording
Use :mic as the input and press Ctrl-C to finish capture. Editor and timeline exports keep a sibling *_RECORDING.mka source so the project remains usable:
auto-editor :mic --export resolve -o interview.fcpxml
# writes interview.fcpxml and interview_RECORDING.mkaWith -c:a auto (the default), persistent recordings use lossless FLAC. Choose another Matroska-supported encoder explicitly; unsupported encoders fail before capture. Encoder sample rates and channel layouts are negotiated during the recording transcode.
auto-editor :mic --export resolve -c:a opus -o interview.fcpxml
auto-editor :mic --sample-rate 44.1kHz --export v3 -o interview.v3Ordinary rendered outputs and clip-sequence use a temporary capture instead; their final audio codec still follows the output container and -c:a.
Naming the timeline
premiere, resolve, and final-cut-pro accept a name attr (default "Auto-Editor Media Group"). Pass extra attrs after a colon:
# POSIX shells
auto-editor example.mp4 --export 'premiere:name="Your name here"'
# PowerShell (double the inner quotes)
auto-editor example.mp4 --export 'premiere:name=""Your name here""'final-cut-pro and resolve also accept version, the FCPXML version to write: 11 (default) for FCPXML 1.11, or 10 for FCPXML 1.10, for an older editor that can't read 1.11.
auto-editor example.mp4 --export final-cut-pro:version=10Split into clips without further editing
To split at the cut points but make no other edits, set both actions to nil:
auto-editor example.mp4 -w:0 nil -w:1 nil --export premiereImporting timelines
auto-editor reads timeline/XML files as inputs and renders them like any media:
auto-editor myFcp7File.xml -o render.mp4 # render an fcp7 xml (experimental)
auto-editor timeline.v3 -o render.mp4 # render an auto-editor timeline fileImporters: auto-editor timeline files (.v1, .v2, .v3) and FCP7 XML (experimental). The input format is detected by extension. PRs for more importers are welcome.
Timeline format notes
.v1/.v2/.v3 are auto-editor's own timeline formats; .v3 is the current layered format (supports stacked tracks / overlay compositing). See <https://auto-editor.com/docs/v3> (and /docs/v1, /docs/v2). Export a timeline to inspect or hand-tweak the edit, then re-import it to render.
For plain rendering, edit methods, and pace, see the auto-editor skill.
