Skip to content

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

6.4 KB
Raw Blame
"""
Hardware-accelerated encoder detection and configuration.

Probes system for available encoders:
- macOS: h264_videotoolbox (M-series / Intel GPU)
- NVIDIA: h264_nvenc
- AMD: h264_amf (Windows)
- Fallback: libx264 (CPU, always available)

Returns optimal FFmpeg encoder flags for the current system.
"""

import subprocess
from utils.proc import run as proc_run, ProcError
import platform
import tempfile
import os
import functools
import sys

from config.paths import paths


@functools.lru_cache(maxsize=1)
def detect_encoders() -> dict:
    """
    Detect available hardware encoders.
    """
    system = platform.system()
    available = ["libx264"]

    candidates = []
    if system == "Darwin":
        candidates = ["h264_videotoolbox"]
    elif system == "Linux":
        candidates = ["h264_nvenc"]
    elif system == "Windows":
        candidates = ["h264_nvenc", "h264_amf", "h264_qsv"]

    for enc in candidates:
        if _test_encoder(enc):
            available.append(enc)

    priority = [
        "h264_videotoolbox",
        "h264_nvenc",
        "h264_amf",
        "h264_qsv",
        "libx264",
    ]

    best = "libx264"
    for enc in priority:
        if enc in available:
            best = enc
            break

    return {
        "available": available,
        "best": best,
        "best_flags": _get_encoder_flags(best),
        "system": system,
    }


def _test_encoder(encoder: str) -> bool:
    """
    Test if an FFmpeg encoder works by encoding a small real video to a temp file.
    Writing to /dev/null or -f null fails for some HW encoders.
    """
    tmp_out = None
    try:
        tmp_fd = tempfile.NamedTemporaryFile(suffix=".mp4", delete=False)
        tmp_out = tmp_fd.name
        tmp_fd.close()
        flags = _get_encoder_flags(encoder)
        cmd = [
            "ffmpeg", "-y",
            "-f", "lavfi", "-i", "color=black:s=320x240:d=0.5:r=24",
            "-f", "lavfi", "-i", "anullsrc=r=44100:cl=mono",
            "-t", "0.5",
            *flags,
            "-c:a", "aac",
            "-shortest",
            tmp_out,
        ]
        result = proc_run(cmd, timeout=15, check=False)
        # Check both return code AND that the file was actually created
        return result.returncode == 0 and os.path.exists(tmp_out) and os.path.getsize(tmp_out) > 100
    except (ProcError, FileNotFoundError, OSError):
        return False
    finally:
        if tmp_out and os.path.exists(tmp_out):
            try:
                os.remove(tmp_out)
            except OSError:
                pass


def _get_encoder_flags(encoder: str) -> list[str]:
    """
    Get optimal FFmpeg flags for a given encoder.
    Kept minimal to avoid conflicts with filter_complex.

    Every H.264 preset states yuv420p. Left unsaid, FFmpeg picks the output
    format by negotiating with the filtergraph, and some filters answer with
    4:4:4 even when every input is 4:2:0. xfade is one of them. The encoders
    that ask for high profile then abort, because high is a 4:2:0-only profile,
    and the ones that do not ask silently write High 4:4:4 Predictive, which
    phones and every social platform refuse to play.
    """
    flags = {
        "h264_videotoolbox": [
            "-c:v", "h264_videotoolbox",
            "-b:v", "6M",              # 6 Mbps, plenty for 1080x1920 vertical
            "-profile:v", "high",
            "-pix_fmt", "yuv420p",
            "-allow_sw", "1",          # Allow software fallback
        ],
        "h264_nvenc": [
            "-c:v", "h264_nvenc",
            "-preset", "p6",           # Slower = higher quality
            "-cq", "18",               # High quality
            "-profile:v", "high",
            "-pix_fmt", "yuv420p",
        ],
        "h264_amf": [
            "-c:v", "h264_amf",
            "-quality", "quality",     # Prioritize quality over speed
            "-rc", "cqp",
            "-qp_i", "18", "-qp_p", "18",
        ],
        "h264_qsv": [
            "-c:v", "h264_qsv",
            "-preset", "slow",
            "-global_quality", "18",
        ],
        "libx264": [
            "-c:v", "libx264",
            "-crf", "18",              # Near-lossless quality
            "-preset", "slow",         # Better compression at same quality
            "-profile:v", "high",
            "-pix_fmt", "yuv420p",
        ],
    }
    return flags.get(encoder, flags["libx264"])


def get_video_encode_flags() -> list[str]:
    """Get the best available encoder flags. Main entry point."""
    try:
        info = detect_encoders()
        return info["best_flags"]
    except Exception:
        # Absolute fallback: never let encoder detection break the pipeline
        print("Warning: encoder detection failed, using libx264", file=sys.stderr)
        return ["-c:v", "libx264", "-crf", "18", "-preset", "slow",
                "-profile:v", "high", "-pix_fmt", "yuv420p"]


def _encoder_cache_path() -> str:
    return os.path.join(paths["cache"], "encoder.json")


def _ffmpeg_fingerprint() -> str:
    """Cheap fingerprint (path + mtime) to invalidate cache when ffmpeg changes."""
    import shutil
    ffbin = os.environ.get("PODCLI_FFMPEG") or shutil.which("ffmpeg") or "ffmpeg"
    try:
        st = os.stat(ffbin)
        return f"{ffbin}:{int(st.st_mtime)}:{st.st_size}"
    except OSError:
        return ffbin


def get_encoder_info() -> dict:
    """Get full encoder detection info (for UI/logging).

    Cached under paths["cache"]/encoder.json keyed by ffmpeg binary fingerprint.
    Encoder probing runs ffmpeg twice (~1.6s on macOS), huge startup win.
    """
    import json
    cache_path = _encoder_cache_path()
    fp = _ffmpeg_fingerprint()

    try:
        with open(cache_path, encoding="utf-8") as f:
            cached = json.load(f)
        if cached.get("fingerprint") == fp and cached.get("system") == platform.system():
            return cached["info"]
    except (OSError, ValueError, KeyError):
        pass

    try:
        info = detect_encoders()
    except Exception:
        info = {"available": ["libx264"], "best": "libx264",
                "best_flags": ["-c:v", "libx264", "-crf", "18", "-preset", "slow",
                               "-profile:v", "high", "-pix_fmt", "yuv420p"],
                "system": platform.system()}

    try:
        os.makedirs(os.path.dirname(cache_path), exist_ok=True)
        with open(cache_path, "w", encoding="utf-8") as f:
            json.dump({"fingerprint": fp, "system": platform.system(), "info": info}, f)
    except OSError:
        pass

    return info