Files
2026-11-16 10:30:06 +01:00

1.0 KiB

FFmpeg Installer Strategy

ClipForge should stay lightweight while still working for users who do not already have FFmpeg installed.

Packaging Behavior

  • pnpm run prepare:ffmpeg prepares src-tauri/binaries/ffmpeg-x86_64-pc-windows-msvc.exe.
  • If the sidecar already exists, the script reuses it. Otherwise, if ffmpeg is on PATH, the script copies that binary into the sidecar location.
  • If ffmpeg is missing, the script downloads the FFmpeg essentials zip and extracts ffmpeg.exe into the sidecar location.
  • src-tauri/tauri.conf.json declares bundle.externalBin = ["binaries/ffmpeg"], so Tauri includes the binary in MSI/NSIS installers.
  • Installed users do not need a separate FFmpeg install; ClipForge checks the bundled sidecar first, then system PATH.

Why This Is Lightweight

Tauri uses the system WebView instead of bundling Chromium. FFmpeg is a single sidecar executable used only for capture/encoding work, not a persistent extra runtime.

Build Commands

pnpm run prepare:ffmpeg
pnpm run desktop:build