Load a video file (mp4, mov, avi, webm, mkv...) into the registry.

Load an audio file (mp3, wav, aac, ogg...) into the registry.

Load a still image (png, jpg...) as a video clip of fixed duration.

Useful for slideshows, intros, watermark sources, and overlays.

Create a solid-color video clip (backgrounds, spacers, title cards).

Create a standalone text clip (titles, captions, credits).

To place text ON TOP of a video, create it here and then use overlay_clip with position and timing.

List every clip currently in the registry with its metadata.

Get full metadata for one clip: duration, size, fps, audio, history.

Remove a clip from the registry and free its resources.

Cut a clip to the range [start_seconds, end_seconds].

Join clips end-to-end, in the given order.

All ids must be the same kind (all video/image, or all audio).

Speed a clip up or down.

Repeat a clip. Give either n_times OR total_duration_seconds.

Resize a video/image clip.

Give exactly one of: scale (e.g. 0.5), width, height, or width+height. A single dimension preserves aspect ratio.

Crop to the rectangle (x1, y1)-(x2, y2). Origin is the top-left.

Rotate counter-clockwise by the given degrees (use -90 for clockwise).

Flip a clip. axis: 'horizontal' (left-right) or 'vertical' (up-down).

Add fade-in and/or fade-out. Works for video (to black) and audio.

Convert a video/image clip to black and white.

Adjust brightness/contrast.

Mask a color in a video clip (chroma key / green screen).

Scale volume: 0.5 = half, 2.0 = double, 0 = silent.

Works on audio clips and on the audio track of video clips.

Pull the audio track out of a video as a new audio clip.

Return a muted copy of a video clip (audio track removed).

Set or mix an audio track onto a video clip.

Place one clip on top of another (text, watermark, picture-in-picture).

Save a single frame of a video as an image (png/jpg).

Useful for thumbnails or letting the user preview an edit.

Render a clip to disk. THIS is the step that writes a file.