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.__init__
• cjm_capability_ffmpeg.capability — FFmpeg-based media processing capability implementing the MediaProcessingCapability interface.
• cjm_capability_ffmpeg.utils.__init__
• 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, and
• 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 —

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.
• get_audio_extension function — Map a detected audio codec to the audio-only container that stream-copies it.

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 audio segment from a media file.

Dependencies

Depends on: cjm-capability-primitives, cjm-substrate, tqdm