Skip to content

Open-source AI podcast clipper. Generate vertical clips with face tracking and burned-in captions. CLI, MCP server, web app.

2.7 KB
Raw Blame
"""Standalone ffprobe wrapper used by integration emitters."""
from __future__ import annotations

import json
import subprocess
from pathlib import Path
from typing import Any


def _run_ffprobe(cmd: list[str], path: str) -> dict[str, Any]:
    try:
        return json.loads(subprocess.check_output(cmd, text=True, stderr=subprocess.PIPE, timeout=30))
    except FileNotFoundError:
        raise RuntimeError("ffprobe not found: install ffmpeg to use editor-export integrations")
    except subprocess.TimeoutExpired:
        raise RuntimeError(f"ffprobe timed out for {path}")
    except subprocess.CalledProcessError as e:
        raise RuntimeError(f"ffprobe failed for {path}: {(e.stderr or '').strip() or e}")
    except json.JSONDecodeError:
        raise RuntimeError(f"ffprobe returned unexpected output for {path}")


def probe_media(path: str | Path) -> dict[str, Any]:
    p = str(Path(path).resolve())

    v_cmd = [
        "ffprobe", "-v", "error",
        "-select_streams", "v:0",
        "-show_entries", "stream=width,height,r_frame_rate,nb_frames,duration",
        "-show_entries", "format=duration",
        "-of", "json",
        p,
    ]
    v_data = _run_ffprobe(v_cmd, p)
    v_stream = (v_data.get("streams") or [{}])[0]
    fmt_duration = float((v_data.get("format") or {}).get("duration") or 0.0)

    width = int(v_stream.get("width", 0))
    height = int(v_stream.get("height", 0))

    rfr = v_stream.get("r_frame_rate", "30/1")
    num_s, den_s = rfr.split("/")
    fps_num, fps_den = float(num_s), float(den_s)
    fps = fps_num / fps_den if fps_den > 0 else 30.0

    # Prefer duration*fps: nb_frames is missing or wrong for many mp4/mov/VFR
    # files, and the timeline length the user expects is the duration.
    duration_s = float(v_stream["duration"]) if v_stream.get("duration") else fmt_duration
    nb_frames_raw = v_stream.get("nb_frames")
    if duration_s > 0:
        duration_frames = round(duration_s * fps)
    elif nb_frames_raw and str(nb_frames_raw).isdigit() and int(nb_frames_raw) > 0:
        duration_frames = int(nb_frames_raw)
    else:
        raise RuntimeError(f"Could not determine duration for {p}")

    a_cmd = [
        "ffprobe", "-v", "error",
        "-select_streams", "a:0",
        "-show_entries", "stream=channels",
        "-of", "json",
        p,
    ]
    a_data = _run_ffprobe(a_cmd, p)
    a_streams = a_data.get("streams") or []
    has_audio = len(a_streams) > 0
    audio_channels = int(a_streams[0].get("channels", 0)) if has_audio else 0

    return {
        "width": width,
        "height": height,
        "fps": fps,
        "duration_frames": duration_frames,
        "has_audio": has_audio,
        "audio_channels": audio_channels,
    }