falaw.local#

Local utilities: ffmpeg + PIL glue for stitching fal outputs.

The fal calls produce URLs. This module materializes them into local files and assembles them into watchable scenes (concat, transitions, thumbnails, etc.). Anything that’s cheap to do locally lives here so the cloud calls stay focused on generation.

ffmpeg is the one external dependency. The functions raise a clear error if it’s missing.

Functions

concatenate_clips(clip_urls, *, output_path)

Materialize each clip and concatenate into one mp4.

extract_thumbnail(clip_url, *, output_path)

Save a single frame from a clip as a PNG.

has_ffmpeg()

overlay_audio(video_url, audio_url, *, ...)

Mix an audio track onto a video clip.
falaw.local.concatenate_clips(clip_urls, *, output_path, transition_s=0.0, audio=True)[source]#

Materialize each clip and concatenate into one mp4.

Parameters:

  • clip_urls (Iterable[str]) – ordered iterable of fal-served clip URLs (or local paths).

  • output_path (str) – where to write the concatenated mp4.

  • transition_s (float) – crossfade duration in seconds (0 = hard cut).

  • audio (bool) – whether to include audio in the output.

Return type:

str

Returns:

The output path.

falaw.local.extract_thumbnail(clip_url, *, output_path, at_seconds=1.0)[source]#

Save a single frame from a clip as a PNG.

Return type:

str

falaw.local.overlay_audio(video_url, audio_url, *, output_path, replace_audio=True)[source]#

Mix an audio track onto a video clip.

With replace_audio=True (default) the original audio is dropped.

Return type:

str