How n-sudy/recap-en-to-mm works
Recap → Myanmar is a Windows video-narration tool: users select a video and narration settings, then receive a Myanmar-voiced video whose picture follows the narration timing. Its distinct stages include local transcription, story-aware translation and segmentation, speech generation, synchronized rendering, and optional subtitle/overlay editing. A separate Splitter tab divides long videos with configurable cuts and presentation. The source excerpts show UI, planning, rendering, preview, and splitting code; several service connections and rendering details are supported only by README descriptions or the source index.
Main entry points: core.py Smart Sync renderer · recap_planner.py Story and timing plan · controller.py Main controls · splitter.py Cut and encode
Components 19
Recap narration
- Main controls
app/controller.py - Whisper transcription
recap_runtime/services/whisper_service.py - Gemini language service
recap_runtime/services/ai_service.py - Story and timing plan
app/recap_planner.py - Narrator speech
app/gemini_tts.py - Narration editor
app/narration_editor.py
Sync and presentation
- Smart Sync renderer
app/core.py - Subtitle cues
app/subtitle_png.py - Subtitle fonts
app/subtitle_fonts.py - Text overlays
services/text_overlay_service.py - Frame preview
app/preview_tools.py
Video splitting
- Splitter controls
app/splitter_tab.py - Cut and encode
app/splitter.py
Other components
- Video creator
- Edge TTS
- Gemini API
- Source video
- Myanmar video
- Video parts
Connections 21
- Video creator → Main controls: selects and configures
README.md - Main controls → Story and timing plan: starts planning
app/controller.py - Story and timing plan → Whisper transcription: transcribes locally
README.md - Story and timing plan → Gemini language service: translates and audits
README.md - Story and timing plan → Narrator speech: generates narration
- Narrator speech → Gemini API: requests speech
- Story and timing plan → Gemini API: requests translation
README.md - Main controls → Smart Sync renderer: starts rendering
app/controller.py - Smart Sync renderer → Source video: reads video
README.md - Smart Sync renderer → Edge TTS: uses Myanmar voice
README.md - Smart Sync renderer → Myanmar video: renders synchronized output
README.md - Smart Sync renderer → Subtitle cues: prepares subtitle track
app/core.py - Subtitle cues → Subtitle fonts: uses font helpers
app/recap_subtitles.py - Smart Sync renderer → Text overlays: renders text overlays
app/core.py - Main controls → Frame preview: refreshes preview
app/controller.py - Main controls → Narration editor: opens text editor
app/controller.py - Narration editor → Story and timing plan: updates narration plan
app/narration_editor.py - Video creator → Splitter controls: chooses split settings
README.md - Splitter controls → Cut and encode: starts splitting
app/splitter_tab.py - Cut and encode → Source video: reads source
README.md - Cut and encode → Video parts: encodes segments
README.md