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 Pro
Export 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.v3
Export 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.mka
With -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.v3
Ordinary 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""'
Split 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 premiere
Importing 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 file
Importers: 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.