How finanf/subtitle-generator works
Subtitle Generator accepts short MP4 uploads through a React interface, processes them through a FastAPI endpoint, and offers the burned-in video for download. The API owns duration validation, temporary-file handling, and calls each documented processing stage; the UI also checks video metadata before upload. The README documents the pipeline and CLI capabilities. Edges follow shown calls and documented relationships; the deployment configuration and unsampled source are not mapped.
Main entry points: api.py Transcription API · App.js Upload interface · index.js React bootstrap · audio_extraction.py Audio extraction
Components 13
Upload interface
- React bootstrap
frontend/src/index.js - Upload interface
frontend/src/App.js - Web vitals
frontend/src/reportWebVitals.js
API workflow
- Transcription API
api/api.py - Temporary video files
api/api.py - Duration validation
api/api.py
Subtitle processing
- Audio extraction
proscessing/audio_extraction.py - Speech transcription
proscessing/generate_transcription.py - SRT generation
proscessing/generate_srt.py - Subtitle burning
proscessing/merge_srt_to_mp4.py
Other components
- Video user
- FFmpeg tools
- Distil-Whisper model
Connections 15
- Video user → Upload interface: selects video
frontend/src/App.js - React bootstrap → Upload interface: renders
frontend/src/index.js - React bootstrap → Web vitals: invokes
frontend/src/index.js - Upload interface → Transcription API: uploads video
frontend/src/App.js - Transcription API → Upload interface: returns download URL
api/api.py - Upload interface → Transcription API: requests download
frontend/src/App.js - Transcription API → Temporary video files: writes and cleans
api/api.py - Transcription API → Duration validation: checks duration
api/api.py - Transcription API → Audio extraction: extracts audio
api/api.py - Transcription API → Speech transcription: transcribes audio
api/api.py - Transcription API → SRT generation: generates SRT
api/api.py - Transcription API → Subtitle burning: burns subtitles
api/api.py - Audio extraction → FFmpeg tools: extracts audio
proscessing/audio_extraction.py - Speech transcription → Distil-Whisper model: runs model
proscessing/generate_transcription.py - Subtitle burning → FFmpeg tools: burns subtitles
proscessing/merge_srt_to_mp4.py