wyattblue/auto-editor

auto-editor-export

Export auto-editor's edit or microphone recording to a video editor (Premiere, DaVinci Resolve, Final Cut Pro, ShotCut, Kdenlive), to individual clips, or to auto-editor timeline files (.v1/.v2/.v3); and import timeline/XML files to render them.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. 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-export

Before 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.
Original skill document

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.

bash
auto-editor video.mp4 --export premiere    # → video_ALTERED.xml for Premiere Pro

Export targets

--exportForOutput
premiereAdobe Premiere Pro (fcp7 xml).xml
resolveDaVinci Resolve (fcpxml).fcpxml
resolve-fcp7Resolve via legacy fcp7 xml.xml
final-cut-proFinal Cut Pro.fcpxml
shotcutShotCut.mlt
kdenliveKdenlive.kdenlive
edlCMX 3600 EDL (Premiere, Resolve, Avid).edl
clip-sequenceindividual media clips, one per kept segmentmedia files
v1 / v2 / v3auto-editor timeline files.v1 / .v2 / .v3
(default)rendered media fileper container
bash
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:

bash
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.

bash
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:

bash
# 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.

bash
auto-editor example.mp4 --export final-cut-pro:version=10

Split into clips without further editing

To split at the cut points but make no other edits, set both actions to nil:

bash
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:

bash
auto-editor myFcp7File.xml -o render.mp4    # render a Premiere/Resolve fcp7 xml
auto-editor project.fcpxmld -o render.mp4   # render a Final Cut Pro export
auto-editor cut.edl -o render.mp4           # render a CMX 3600 EDL
auto-editor timeline.v3 -o render.mp4       # render an auto-editor timeline file

Importers: auto-editor timeline files (.v1, .v2, .v3), FCP7 XML (Premiere Pro, DaVinci Resolve), FCPXML (.fcpxml files and the .fcpxmld bundles Final Cut Pro exports), and CMX 3600 EDLs (.edl). The input format is detected by extension.

An EDL names no frame rate: auto-editor reads it from the first video file the EDL names, and failing that guesses from the timecodes; pass --frame-rate to set it. Media is found by the * SOURCE FILE: comment, else the clip name relative to the EDL. An EDL holds one video track and four audio channels, with cuts, dissolves, wipes and M2 speed changes; edl export leaves out the rest.

FCPXML import reads the primary storyline, connected clips (lanes above become video layers; lanes below contribute audio only), transitions, speed (including ramps), and volume. Compound, synchronized, and multicam clips are left out with a warning.

Which transitions each export and import carries is covered by the auto-editor-transitions skill.

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.

from this repository

More skills

All skills
wyattblue
Community

auto-editor

Record a microphone or edit video/audio with the auto-editor CLI — cut out dead space (silence, motionlessness, black frames), set the pace, make manual cuts, and render the result. Use when someone wants to capture and trim a microphone, remove silence, shorten a recording, speed through quiet parts, or otherwise edit media with auto-editor.

1h installs
1
GitHub stars
5.9K
Updated
Nov 16
wyattblue
Community

auto-editor-effects

Apply actions and animations to sections of a video/audio with auto-editor — change speed, duck or fade volume, de-ess, zoom/Ken Burns, rotate/spin, draw boxes, overlay logos or picture-in-picture, and animate any of these with ramps and easing. Use when someone wants creative effects or per-section behavior rather than plain silence-cutting.

1h installs
1
GitHub stars
5.9K
Updated
Nov 16
wyattblue
Community

auto-editor-transcribe

Transcribe a media file or live microphone to text or subtitles with auto-editor's whisper subcommand, then edit by spoken content — cut to keep (or drop) sections whose subtitles match a word or regex. Use when someone wants a transcript, captions, live speech transcription, or to cut a video based on what is said rather than on loudness.

1h installs
1
GitHub stars
5.9K
Updated
Nov 16
wyattblue
Community

auto-editor-transitions

Add transitions at auto-editor's cuts — cross-dissolves, Premiere Pro's transitions (push, clock-wipe, glitch, page-peel, iris-round, and the rest, including its Legacy folder), and audio crossfades — and carry them into Premiere, DaVinci Resolve, Final Cut Pro, Shotcut or Kdenlive. Use when someone wants smoother cuts, fades at the start and end, a particular transition, or transitions that survive an editor export or import.

1h installs
1
GitHub stars
5.9K
Updated
Nov 16