π« The Pain Point
You have a video with an SRT subtitle file. You need the subtitles burned into the video so they show up everywhere, even on devices that donβt support external subtitles.
π Agentic Solution
A Subtitle Burner that permanently embeds text into the video.
Key Features:
- Font Customization: Size, color, outline, position.
- Multiple Formats: SRT, ASS, VTT support.
- Batch Mode: Process multiple videos.
βοΈ Phase 1: Commander (Quick Fix)
For quick burning.
Prompt:
βI have a video
movie.mp4and subtitlesmovie.srt. Write a Python script using FFmpeg to:
- Burn: Embed subtitles into video permanently.
- Style: White text, black outline, bottom center.
- Font Size: 24pt.
- Output: Save as
movie_subtitled.mp4.Handle encoding issues (UTF-8 subtitles). Print progress.β
Result: Video with embedded subtitles.
ποΈ Phase 2: Architect (Permanent Tool)
For Content Creators.
Engineering Prompt:
**Role:** Python GUI Developer (PyQt6 Specialist)
**Task:** Create "Subtitle Burner" Desktop App
**Objective:** A desktop tool to permanently burn captions into videos with custom styling.
**Tech Stack:**
* Language: Python 3.10+
* GUI Library: PyQt6 (Cross-platform)
* Media Processing: FFmpeg (via subprocess)
* Packaging: PyInstaller
**Functional Requirements:**
1. **UI Layout (PyQt6):**
* **Inputs:** Video File (.mp4) and Subtitle File (.srt/.ass) selection.
* **Styling:** Font Family dropdown, Size slider, Color picker (Text/Outline), Position (Bottom/Top).
* **Status:** Real-time log output window.
2. **Core Logic:**
* Construct complex FFmpeg command based on UI inputs.
* `text={text}:fontsize={size}:fontcolor={color}`
* **Threading:** Execute FFmpeg process in `QProcess` or `QThread` to keep UI alive and show progress.
3. **Deliverables:**
* `main.py`: Complete source code.
* `requirements.txt`: Dependencies.
* **Build Instructions:**
* Windows: `pyinstaller --onefile --noconsole main.py`
* macOS: `pyinstaller --windowed --noconsole main.py`
π§ Prompt Decoding
- Hardcoded vs Softcoded: Hardcoded (burned) subtitles are part of the video pixels. Cannot be turned off but work everywhere.
π οΈ Instructions
- Install FFmpeg.
- Copy Prompt β Run.