Function download_and_trim

ci/tools/generate_audio_fixtures.py:112–157

Download audio from URL, trim to DURATION_S, normalize, resample to OGG.

(
    ffmpeg: str, url: str, start: str, output: Path, cache_dir: Path
)

def download_and_trim(
    ffmpeg: str, url: str, start: str, output: Path, cache_dir: Path
) -> bool:
    """Download audio from URL, trim to DURATION_S, normalize, resample to OGG."""
    # Cache the raw download
    url_hash = hashlib.md5(url.encode()).hexdigest()[:12]
    cached = cache_dir / f"raw_{url_hash}.mp3"

    if not cached.exists():
        print(f"  Downloading {url[:80]}...")
        try:
            import urllib.request

            urllib.request.urlretrieve(url, str(cached))
        except KeyboardInterrupt as ki:
            import _thread

            _thread.interrupt_main()
            raise SystemExit(1) from ki
        except Exception as e:
            print(f"  Download failed: {e}", file=sys.stderr)
            return False

    # Trim + normalize + resample + encode
    run_ffmpeg(
        ffmpeg,
        [
            "-ss",
            start,
            "-t",
            str(DURATION_S),
            "-i",
            str(cached),
            "-af",
            f"loudnorm=I=-10:LRA=7:TP=-1,aresample={SAMPLE_RATE}",
            "-ac",
            str(CHANNELS),
            "-c:a",
            "libvorbis",
            "-b:a",
            OGG_BITRATE,
            str(output),
        ],
        f"Processing -> {output.name}",
    )
    return True


def generate_synthetic_stem(ffmpeg: str, stem_type: str, output: Path) -> None: