Edit Reference

When you run:

auto-editor example.mp4 --edit audio:0.05,stream=0

You're writing the syntax-sugary equivalent of:

auto-editor example.mp4 --edit "(audio 0.05 (= stream 0))"

All the edit methods are listed below:

Edit Methods

(audio [threshold] [stream]) → BoolArray

 threshold: Unorm16 = 0.04

 stream: (U Natural 'all) = all

Do a one-pass audio filter based on the loudest sample in a timebase section, divided by the max value a sample can be.

(motion [threshold] [stream] [width] [blur]) → BoolArray

 threshold: Unorm16 = 0.02

 stream: Natural = 0

 width: Natural = 400

 blur: Natural = 9

Scale the video to width pixels, convert to grayscale, apply a Gaussian blur of blur amount, then compare the difference with the previous frame.

(blackdetect [threshold] [stream] [pixel-black]) → BoolArray

 threshold: Unorm16 = 0.98

 stream: Natural = 0

 pixel-black: Float = 0.10

Mark a frame as loud when at least threshold of its pixels are black, where a pixel counts as black when its grayscale luma is at or below pixel-black. Wrap in not to instead cut black frames.

(subtitle pattern [stream] [ignore-case]) → BoolArray
(regex pattern [stream] [ignore-case]) → BoolArray

 pattern: String

 stream: Natural = 0

 ignore-case: Bool = #f

When pattern, a RegEx expression, matches a subtitle line, consider the time that line occupies as loud.

(word value [stream] [ignore-case]) → BoolArray

 value: String

 stream: Natural = 0

 ignore-case: Bool = #t

When value, matched as a whole word, appears in a subtitle line, consider the time that line occupies as loud. Case-insensitive by default.

Operators

(or operand ...) → BoolArray

 operand: BoolArray

"Logical Or" two or more boolean arrays. If they are different lengths, use the biggest one.

(and operand ...) → BoolArray

 operand: BoolArray

"Logical And" two or more boolean arrays. If they are different lengths, use the smallest one.

(xor operand ...) → BoolArray

 operand: BoolArray

"Logical Xor" two or more boolean arrays.

(not operand) → BoolArray

 operand: BoolArray

Invert a boolean array.