mixing.transcript.media

ffmpeg-backed audio extraction and timeline-cut application.

These functions shell out to ffmpeg (which must be on PATH); they have no Python dependencies beyond the stdlib.

Functions

apply_keeps(input_path, output_path, keeps, *)

Re-encode input_path keeping only the listed time ranges.

extract_audio(input_path, output_path, *[, ...])

Extract a mono mp3 from input_path (suitable for STT).
mixing.transcript.media.apply_keeps(input_path, output_path, keeps, *, video_codec='libx264', audio_codec='aac', crf=20, preset='medium', audio_bitrate='160k', faststart=True, overwrite=True)[source]

Re-encode input_path keeping only the listed time ranges.

Parameters:

  • input_path (Union[str, Path]) – Input audio/video file.

  • output_path (Union[str, Path]) – Output file (extension picks the container).

  • keeps (Sequence[dict]) – [{"start": float, "end": float}, ...] time ranges in seconds.

  • audio_bitrate (str) – Re-encode knobs forwarded to ffmpeg.

  • faststart (bool) – Add -movflags +faststart (mp4 web-streaming).

  • overwrite (bool) – Pass -y to ffmpeg.

Return type:

Path

Returns:

The output path.

mixing.transcript.media.extract_audio(input_path, output_path, *, sample_rate=16000, channels=1, bitrate='96k', overwrite=True)[source]

Extract a mono mp3 from input_path (suitable for STT).

Returns the output path.

Return type:

Path