scripts/README.md

FFmpeg wrapper scripts (Windows PowerShell)

Purpose

These scripts add the repository's bundled FFmpeg binary (under ffmpeg-8.0-essentials_build/bin) to the PATH for the current PowerShell session and provide a convenience launcher to run the Gradio app using that PATH.

Files

• add_ffmpeg_path.ps1 — Prepend the repo ffmpeg-8.0-essentials_build/bin folder to the current session PATH. Does not modify system PATH permanently.
• run_app_with_ffmpeg.ps1 — Calls add_ffmpeg_path.ps1, optionally activates .venv if present, and runs app.py with the current Python.

Usage

Open PowerShell in the repo root and run:

# Make sure execution policy allows script running (temporary bypass)
powershell.exe -ExecutionPolicy Bypass -File .\scripts\run_app_with_ffmpeg.ps1

Or run add_ffmpeg_path.ps1 directly to just update PATH in the session:

. .\scripts\add_ffmpeg_path.ps1
# Now check ffmpeg
ffmpeg -version

Notes

• These scripts only affect the current PowerShell session.
• If you prefer permanent PATH updates, add the ffmpeg bin folder to your system/user PATH.
• The app expects GOOGLE_API_KEY to be set (or a .env file with that variable) and the FAISS index/metadata files to be present.