auto-editor-export

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

默认情况下，auto-editor 会渲染媒体文件。

--export

（

-ex

）用于更改导出目标。输出扩展名会根据模式自动选择。

bash

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

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`	目标	输出
`premiere`	Adobe Premiere Pro（fcp7 xml）	`.xml`
`resolve`	DaVinci Resolve（fcpxml）	`.fcpxml`
`resolve-fcp7`	通过旧版 fcp7 xml 导出到 Resolve	`.xml`
`final-cut-pro`	Final Cut Pro	`.fcpxml`
`shotcut`	ShotCut	`.mlt`
`kdenlive`	Kdenlive	`.kdenlive`
`clip-sequence`	单个媒体片段，每个保留片段对应一个	媒体文件
`v1` / `v2` / `v3`	auto-editor 时间线文件	`.v1` / `.v2` / `.v3`
（默认）	已渲染的媒体文件	取决于容器格式

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

将

:mic

作为输入并按 Ctrl-C 结束录制。编辑器导出和时间线导出会保留同级的

*_RECORDING.mka

源文件，确保项目仍可使用：

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


使用 `-c:a auto`（默认值）时，持续录制会采用无损 FLAC。请显式选择其他受 Matroska 支持的编码器；不支持的编码器会在开始录制前报错。编码器采样率和声道布局会在录制转码期间协商确定。

```bash
auto-editor :mic --export resolve -c:a opus -o interview.fcpxml
auto-editor :mic --sample-rate 44.1kHz --export v3 -o interview.v3

普通渲染输出和

clip-sequence

则改用临时录制；其最终音频编码器仍取决于输出容器和

-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

undefined

premiere

、

resolve

和

final-cut-pro

接受

name

attr（默认值为 "Auto-Editor Media Group"）。在冒号后传入额外的 attrs：

bash

undefined

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""'

undefined

auto-editor example.mp4 --export 'premiere:name=""Your name here""'

undefined

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

要在剪切点处分割但不进行其他编辑，请将两个操作都设置为

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

auto-editor 可以将时间线/XML 文件作为输入读取，并像处理其他媒体一样对其进行渲染：

bash

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

导入器：auto-editor 时间线文件（

.v1

、

.v2

、

.v3

）和 FCP7 XML（实验性）。输入格式会根据扩展名自动检测。欢迎提交更多导入器的 PR。

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.

.v1

.v2

.v3

是 auto-editor 自有的时间线格式；

.v3

是当前的分层格式（支持堆叠轨道/叠加合成）。请参阅 https://auto-editor.com/docs/v3（以及

/docs/v1

、

/docs/v2

）。导出一个时间线以检查或手动调整剪辑，然后重新导入并渲染。

有关常规渲染、剪辑方法和节奏，请参阅 auto-editor skill。