User Guide: AI Video Transcriber & Translator V2

This tool automates the process of extracting audio from videos, transcribing it using OpenAI Whisper, translating the text via AI (Gemini, Llama3, or Google), and embedding the results back into the video as soft subtitles.

📋 Prerequisites

FFmpeg: Must be installed on your host system.
- On Bazzite: brew install ffmpeg
Ollama (Optional but Recommended): For private, local translation.
- Run ./ai_transcriber_v2/install_local_llm.sh
- Pull a model: ollama pull llama3

Python Packages:

pip install -r ai_transcriber_v2/requirements.txt

🚀 How to Run

1. The Easy Way (Wizard)

Perfect for first-time runs or single folders.

./ai_transcriber_v2/run_wizard_v2.py

Follow the interactive prompts to set your languages, model size, and preferences.

2. The Power Way (CLI)

For advanced automation.

python3 ai_transcriber_v2/main.py /path/to/videos --lang English --prefer-local --embed --cleanup

3. The Library Fixer (Recovery)

If you have a folder with existing transcripts or partial translations that need fixing:

./ai_transcriber_v2/recover_and_fix_v2.py /path/to/folder

This script intelligently scans for missing translations or translations that don't match the video duration.

🛠 Features

Prefer Local LLM: Use --prefer-local to prioritize your laptop's GPU (via Ollama) for all translations.
Safety First: The script will NEVER replace your original video if the new one is significantly smaller or has a different duration.
Diarization: Use --diarize to identify different speakers (requires HuggingFace token).
Graceful Exit: Press Ctrl+C once to stop the script. It will finish the current file and save its progress before closing.

📂 File Naming Convention

video.srt: Original language transcript.
video.English.srt: Gemini translated subtitles.
video.English.deep_translate.srt: Google Translate subtitles.
video.English.local_llm.srt: Ollama translated subtitles.
video.subbed.mp4: The final result with embedded soft-subs.

2.1 KiB Raw Blame History