auto-editor

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Editing with auto-editor

使用auto-editor编辑

auto-editor analyzes a media file, marks every timebase section as active (e.g. loud) or inactive (e.g. silent), then applies an action to each. The defaults: keep active sections unchanged, cut inactive ones.

bash

auto-editor path/to/video.mp4          # writes video_ALTERED.mp4
auto-editor video.mp4 -o out.mp4       # choose the output name

Run the installed

auto-editor

, or

./auto-editor

from this repo.

auto-editor info FILE

shows streams/codecs/duration;

--preview

prints what would be cut and exits without rendering — use it to sanity-check before a long render.

auto-editor分析媒体文件，将每个时基段标记为活跃（如响亮）或非活跃（如静音），然后对每个段应用操作。默认设置：保持活跃段不变，剪切非活跃段。

bash

auto-editor path/to/video.mp4          # writes video_ALTERED.mp4
auto-editor video.mp4 -o out.mp4       # choose the output name

运行已安装的

auto-editor

，或从本仓库运行

./auto-editor

。

auto-editor info FILE

显示流/编解码器/时长；

--preview

打印将被剪切的内容并退出而不渲染——在长时间渲染前用它进行合理性检查。

Record and edit a microphone

录制并编辑麦克风

Use

:mic

as the input on macOS, Windows, or Linux. Stop capture gracefully with Ctrl-C; auto-editor then analyzes and edits the recording normally.

bash

auto-editor :mic                                      # → mic_ALTERED.wav
auto-editor :mic --sample-rate 44.1kHz -o trimmed.m4a
auto-editor :mic --edit audio:threshold=6%

All normal edit, action, and rendering options apply. Editor and timeline exports preserve the source capture separately; use the auto-editor-export skill for recording-codec and naming details.

在macOS、Windows或Linux上使用

:mic

作为输入。用Ctrl-C优雅地停止捕获；auto-editor随后正常分析和编辑录音。

bash

auto-editor :mic                                      # → mic_ALTERED.wav
auto-editor :mic --sample-rate 44.1kHz -o trimmed.m4a
auto-editor :mic --edit audio:threshold=6%

所有常规编辑、操作和渲染选项均适用。编辑器和时间线导出会单独保留源捕获；有关录制编解码器和命名详情，请使用auto-editor-export skill。

1. Choose what counts as "active" —

--edit METHOD

1. 选择什么算作“活跃”——

--edit METHOD

audio:threshold=0.04,stream=all

is the default. Threshold takes a 0–1 fraction or a

dB

value (case-sensitive).

Method	Marks active when…	Key args (defaults)
`audio`	loudest sample ≥ threshold	`threshold=0.04` , `stream=all`
`motion`	frame-to-frame change ≥ threshold	`threshold=0.02` , `stream=0` , `width=400` , `blur=9`
`blackdetect`	frame is mostly black	`threshold=0.98` , `pixel-black=0.10` (wrap in `not` to cut black)
`subtitle` / `regex`	a subtitle line matches `pattern`	`pattern` (required), `ignore-case=#f`
`word`	a whole word appears in subtitles	`value` (required), `ignore-case=#t`
`1` / `0`	every / no moment is active (keep-all / cut-all)	aliases `none` / `all` ; a base for manual ranges

bash

auto-editor video.mp4 --edit audio:threshold=0.04
auto-editor video.mp4 --edit audio:-19dB            # dB form
auto-editor video.mp4 --edit motion:threshold=0.02
auto-editor video.mp4 --edit blackdetect            # cut to remove black: --edit "(not blackdetect:0.98)"

Combine streams/methods with boolean operators

or

and

xor

not

. Inside an operator, give the method an explicit arg in call form (

audio:0.04

, not bare

audio

) — a bare method there errors with

Bad kind

bash

auto-editor multi.mov --edit "(or audio:stream=0 audio:threshold=10%,stream=1)"
auto-editor video.mp4 --edit "(or audio:0.03 motion:0.06)"   # threshold is always positional arg 1
auto-editor video.mp4 --edit "(not audio:0.04)"              # invert: keep the quiet parts

audio:threshold=0.04,stream=all

是默认值。threshold接受0–1的小数或

dB

值（区分大小写）。

方法	当…时标记为活跃	关键参数（默认值）
`audio`	最大声样本 ≥ threshold	`threshold=0.04` , `stream=all`
`motion`	帧间变化 ≥ threshold	`threshold=0.02` , `stream=0` , `width=400` , `blur=9`
`blackdetect`	帧大部分为黑色	`threshold=0.98` , `pixel-black=0.10` （用 `not` 包裹以剪切黑色画面）
`subtitle` / `regex`	字幕行匹配 `pattern`	`pattern` （必需）, `ignore-case=#f`
`word`	字幕中出现完整单词	`value` （必需）, `ignore-case=#t`
`1` / `0`	每个 / 没有时刻是活跃的（全部保留/全部剪切）	别名 `none` / `all` ；手动范围的基础

bash

auto-editor video.mp4 --edit audio:threshold=0.04
auto-editor video.mp4 --edit audio:-19dB            # dB form
auto-editor video.mp4 --edit motion:threshold=0.02
auto-editor video.mp4 --edit blackdetect            # cut to remove black: --edit "(not blackdetect:0.98)"

使用布尔运算符

or

、

and

、

xor

、

not

组合流/方法。在运算符内部，以调用形式给方法显式参数（

audio:0.04

，而不是裸

audio

）——裸方法会报错

Bad kind

：

bash

auto-editor multi.mov --edit "(or audio:stream=0 audio:threshold=10%,stream=1)"
auto-editor video.mp4 --edit "(or audio:0.03 motion:0.06)"   # threshold is always positional arg 1
auto-editor video.mp4 --edit "(not audio:0.04)"              # invert: keep the quiet parts

Labels — more than just silent vs. loud (

--edit:N

--when:N

)

标签——不仅仅是静音与响亮（

--edit:N

--when:N

）

Every moment is tagged with an integer label (0–255), and each label has an action. Two labels are built in:

Label	Meaning	Set the membership with	Set the action with (default)
`0`	silent / inactive	(whatever `--edit` does not match)	`--when-inactive` = `-w:0` = `--when:0` ( `cut` )
`1`	normal / active	`--edit EXPR` (i.e. `--edit:1 EXPR` )	`--when-active` = `-w:1` = `--when:1` ( `nil` )

So plain

--edit audio

is shorthand for

--edit:1 audio

: matched moments become label 1, the rest stay 0.

-w:0

-w:1

are just

--when:0

--when:1

Add custom classes with

--edit:N EXPR

(N = 2–255) and give each its own action with

--when:N ACTION

(default

nil

= keep). Where classes overlap, the higher label wins:

bash

undefined

每个时刻都标有一个整数标签（0–255），每个标签有一个动作。内置两个标签：

标签	含义	用…设置成员资格	用…设置动作（默认）
`0`	静音/非活跃	（ `--edit` 不匹配的内容）	`--when-inactive` = `-w:0` = `--when:0` （ `cut` ）
`1`	正常/活跃	`--edit EXPR` （即 `--edit:1 EXPR` ）	`--when-active` = `-w:1` = `--when:1` （ `nil` ）

所以普通

--edit audio

是

--edit:1 audio

的简写：匹配的时刻变为标签1，其余保持0。

-w:0

-w:1

就是

--when:0

--when:1

。

使用

--edit:N EXPR

（N = 2–255）添加自定义类，并用

--when:N ACTION

（默认

nil

=保留）为每个类指定动作。当类重叠时，较高的标签胜出：

bash

undefined

Cut silence (0) and keep speech (1) as usual, but also zoom wherever there's motion (2)

auto-editor video.mp4 --edit:2 motion:0.02 --when:2 zoom:2 auto-editor video.mp4 -e:2 motion:0.1 -w:2 speed:2 # -e/-w short forms

Three tiers: cut silence, keep quiet speech at 1x, speed up the loud parts

auto-editor talk.mp4 --edit audio:-30dB --edit:2 audio:-12dB --when:2 speed:1.5


`--edit:0` is rejected — label 0 is the implicit silent class; use `--when:0` to
act on silent moments. (The `--edit 1` / `--edit 0` *values* above are unrelated:
they set label 1's expression to the all-true / all-false constant.)

auto-editor talk.mp4 --edit audio:-30dB --edit:2 audio:-12dB --when:2 speed:1.5


`--edit:0`被拒绝——标签0是隐式的静音类；使用`--when:0`对静音时刻执行操作。（上面的`--edit 1`/`--edit 0` *值*与此无关：它们将标签1的表达式设置为全真/全假常量。）

2. Set the pace —

--margin

and

--smooth

2. 设置节奏——

--margin

和

--smooth

bash

auto-editor video.mp4 --margin 0.2sec        # default: pad each kept section by 0.2s both sides
auto-editor video.mp4 --margin 0.3s,1.5sec   # 0.3s before, 1.5s after (avoids clipped words)
auto-editor video.mp4 --smooth 0.2s,0.1s     # min-cut 0.2s, min-clip 0.1s (default); --smooth 0 = off

bash

auto-editor video.mp4 --margin 0.2sec        # default: pad each kept section by 0.2s both sides
auto-editor video.mp4 --margin 0.3s,1.5sec   # 0.3s before, 1.5s after (avoids clipped words)
auto-editor video.mp4 --smooth 0.2s,0.1s     # min-cut 0.2s, min-clip 0.1s (default); --smooth 0 = off

3. Manual edits — range syntax

3. 手动编辑——范围语法

--cut

--keep

--set-speed

--set-action

take

START,STOP

ranges. Start is inclusive, stop exclusive. Default unit is the timebase; add

sec

(

second

) for seconds. Vars

start

end

; negatives count from the end. Ranges combine with automatic edits, or use

--edit 0

--edit 1

for manual-only editing.

bash

auto-editor video.mp4 --cut 0,30 -10sec,end    # drop first 30 frames and last 10s
auto-editor video.mp4 --keep 0,30sec           # force-keep first 30s regardless of loudness
auto-editor video.mp4 --set-speed 2,0,30       # SPEED,START,STOP: 2x over frames 0–29
auto-editor video.mp4 --edit 1 --cut 0,5sec    # no auto cuts, just drop first 5s
auto-editor video.mp4 --edit 0 --keep 0,5sec   # keep only the first 5s

--cut

、

--keep

、

--set-speed

、

--set-action

接受

START,STOP

范围。起点包含，终点不包含。默认单位是timebase；添加

sec

（

second

）表示秒。变量

start

end

；负数从末尾计数。范围可与自动编辑结合，或使用

--edit 0

--edit 1

进行仅手动编辑。

bash

auto-editor video.mp4 --cut 0,30 -10sec,end    # drop first 30 frames and last 10s
auto-editor video.mp4 --keep 0,30sec           # force-keep first 30s regardless of loudness
auto-editor video.mp4 --set-speed 2,0,30       # SPEED,START,STOP: 2x over frames 0–29
auto-editor video.mp4 --edit 1 --cut 0,5sec    # no auto cuts, just drop first 5s
auto-editor video.mp4 --edit 0 --keep 0,5sec   # keep only the first 5s

4. Reverse the edit — see what gets cut

4. 反转编辑——查看将被剪切的内容

bash

auto-editor video.mp4 --when-active cut --when-inactive nil   # keep the silence, cut the loud parts

bash

auto-editor video.mp4 --when-active cut --when-inactive nil   # keep the silence, cut the loud parts

5. Render & file size

5. 渲染与文件大小

bash

auto-editor video.mp4 -c:v hevc -b:v 0       # variable bitrate
auto-editor video.mp4 -b:v 230k              # target a bitrate to shrink the file
auto-editor video.mp4 -crf 23 -preset medium # quality-based encoding
auto-editor video.mp4 --scale 0.5            # halve the resolution
auto-editor video.mp4 -anorm ebu             # EBU R128 loudness normalize (or peak:-3)

Larger-than-expected files are usually a too-high auto bitrate — set

-b:v

-crf

auto-editor cache

lists/

cache clear

s the analysis cache.

bash

auto-editor video.mp4 -c:v hevc -b:v 0       # variable bitrate
auto-editor video.mp4 -b:v 230k              # target a bitrate to shrink the file
auto-editor video.mp4 -crf 23 -preset medium # quality-based encoding
auto-editor video.mp4 --scale 0.5            # halve the resolution
auto-editor video.mp4 -anorm ebu             # EBU R128 loudness normalize (or peak:-3)

文件比预期大通常是因为自动比特率过高——设置

-b:v

或

-crf

。

auto-editor cache

列出/

cache clear

清除分析缓存。

Going further

进一步了解

Creative effects (speed/zoom/overlays/animations) → auto-editor-effects skill
Export to Premiere/Resolve/Final Cut, clip-sequence, or
```
.v1/.v2/.v3
```
timelines → auto-editor-export skill
Transcribe audio and cut by spoken words → auto-editor-transcribe skill
Full option list:
```
auto-editor --help
```
or https://auto-editor.com/ref/options.md

创意效果（速度/缩放/叠加/动画）→ auto-editor-effects skill
导出到Premiere/Resolve/Final Cut、剪辑序列或
```
.v1/.v2/.v3
```
时间线 → auto-editor-export skill
转录音频并按语音内容剪切 → auto-editor-transcribe skill
完整选项列表：
```
auto-editor --help
```
或https://auto-editor.com/ref/options.md

auto-editor

Original

Translation

Editing with auto-editor

使用auto-editor编辑

Record and edit a microphone

录制并编辑麦克风

1. Choose what counts as "active" —
`--edit METHOD`

1. 选择什么算作“活跃”——
`--edit METHOD`

Labels — more than just silent vs. loud (
`--edit:N`
,
`--when:N`
)

标签——不仅仅是静音与响亮（
`--edit:N`
,
`--when:N`
）

Cut silence (0) and keep speech (1) as usual, but also zoom wherever there's motion (2)

Cut silence (0) and keep speech (1) as usual, but also zoom wherever there's motion (2)

Three tiers: cut silence, keep quiet speech at 1x, speed up the loud parts

Three tiers: cut silence, keep quiet speech at 1x, speed up the loud parts

2. Set the pace —
`--margin`
and
`--smooth`

2. 设置节奏——
`--margin`
和
`--smooth`

3. Manual edits — range syntax

3. 手动编辑——范围语法

4. Reverse the edit — see what gets cut

4. 反转编辑——查看将被剪切的内容

5. Render & file size

5. 渲染与文件大小

Going further

进一步了解

auto-editor

Original

Translation

Editing with auto-editor

使用auto-editor编辑

Record and edit a microphone

录制并编辑麦克风

1. Choose what counts as "active" — --edit METHOD

1. 选择什么算作“活跃”——--edit METHOD

Labels — more than just silent vs. loud (--edit:N, --when:N)

标签——不仅仅是静音与响亮（--edit:N, --when:N）

Cut silence (0) and keep speech (1) as usual, but also zoom wherever there's motion (2)

Cut silence (0) and keep speech (1) as usual, but also zoom wherever there's motion (2)

Three tiers: cut silence, keep quiet speech at 1x, speed up the loud parts

Three tiers: cut silence, keep quiet speech at 1x, speed up the loud parts

2. Set the pace — --margin and --smooth

2. 设置节奏——--margin和--smooth

3. Manual edits — range syntax

3. 手动编辑——范围语法

4. Reverse the edit — see what gets cut

4. 反转编辑——查看将被剪切的内容

5. Render & file size

5. 渲染与文件大小

Going further

进一步了解

1. Choose what counts as "active" —
`--edit METHOD`

1. 选择什么算作“活跃”——
`--edit METHOD`

Labels — more than just silent vs. loud (
`--edit:N`
,
`--when:N`
)

标签——不仅仅是静音与响亮（
`--edit:N`
,
`--when:N`
）

2. Set the pace —
`--margin`
and
`--smooth`

2. 设置节奏——
`--margin`
和
`--smooth`