cjm-capability-ffmpeg

An FFmpeg-based media-processing capability for the cjm-substrate runtime that provides audio extraction, segmentation, and format conversion.

Modules

• cjm_capability_ffmpeg.capability — FFmpeg-based media processing capability implementing the MediaProcessingCapability interface.
• cjm_capability_ffmpeg.utils.availability — Detect whether the ffmpeg binary is installed on this system.
• cjm_capability_ffmpeg.utils.codec — Map audio container formats to the ffmpeg codec used to encode them.
• cjm_capability_ffmpeg.utils.probe — Probe media files for metadata (duration, ...) via ffprobe.
• cjm_capability_ffmpeg.utils.progress — Run ffmpeg subprocess commands with a progress bar and optional callback.
• cjm_capability_ffmpeg.utils.segments — Extract temporal AUDIO segments from media files via ffmpeg stream-copy — audio-only by contract (-vn): a video input yields an audio segment, never a re-encoded video clip.

API

cjm_capability_ffmpeg.capability

• FFmpegCapabilityConfig class — Configuration for the FFmpeg processing tool (the HOW knobs only).
• FFmpegProcessingCapability class — FFmpeg-based media-processing tool capability (stage 8: pure compute).

cjm_capability_ffmpeg.utils.codec

• get_audio_codec function — Map an audio container format to the appropriate ffmpeg codec.

cjm_capability_ffmpeg.utils.probe

• get_media_duration function — Get the duration of a media file (seconds) via ffprobe.

cjm_capability_ffmpeg.utils.progress

• parse_progress_line function — Parse a progress line from ffmpeg stderr output.
• run_ffmpeg_with_progress function — Run an ffmpeg command with a progress bar.

cjm_capability_ffmpeg.utils.segments

• extract_audio_segment function — Extract a temporal segment from an audio file.