How zeta-loop/subvela works
SubVela is a desktop subtitle-production app. Its main workflow runs from video selection through transcription, subtitle review/editing, optional translation, styling and export with burned-in subtitles. The graph includes shared subtitle state and rendering, plus the documented local/cloud model options. Several links come from the SOURCE INDEX or README rather than sampled implementation excerpts, so unsampled details and uncertain runtime wiring are not expanded.
Main entry points: app.py Application shell · transcribe_panel.py Transcription controls · export_panel.py Export controls · style_panel.py Subtitle styling
Components 29
Desktop workflow
- Application shell
app/app.py - Video selection
ui/panels/video_panel.py - Video preview
ui/video_preview.py - Video utilities
core/video_utils.py - Application state
app/state.py
Speech and translation
- Transcription controls
ui/panels/transcribe_panel.py - Local transcription
core/transcriber.py - Cloud transcription
core/cloud_transcriber.py - Translation router
core/translator.py - Local NLLB
core/translation_nllb.py - Cloud translation
core/translation_llm.py
Subtitle editing
- Subtitle review
ui/subtitle_list.py - Subtitle data model
core/subtitle_model.py - Subtitle styling
ui/panels/style_panel.py - Style presets
core/presets.py - Font catalog
core/font_catalog.py - Subtitle renderer
core/subtitle_renderer.py
Export and rendering
- Export controls
ui/panels/export_panel.py - Video subtitle burn
export/ffmpeg_burner.py - ASS subtitle writer
export/ass_writer.py - SRT subtitle writer
export/srt_writer.py - Text subtitle writer
export/txt_writer.py - Subtitle text formatting
export/text_content.py
Settings and services
- Provider settings
ui/panels/settings_panel.py - Configuration and keys
core/config.py
Other components
- Video editor
- FFmpeg
- Cloud speech APIs
- Cloud translation APIs
Connections 35
- Video editor → Application shell: uses
README.md - Application shell → Video selection: creates
app/app.py - Application shell → Transcription controls: creates
app/app.py - Application shell → Subtitle styling: creates
app/app.py - Application shell → Export controls: creates
app/app.py - Application shell → Provider settings: creates
app/app.py - Application shell → Video preview: creates
app/app.py - Application shell → Subtitle review: creates
app/app.py - Video selection → Video utilities: uses
ui/panels/video_panel.py - Transcription controls → Local transcription: starts local transcription
ui/panels/transcribe_panel.py - Transcription controls → Cloud transcription: starts cloud transcription
ui/panels/transcribe_panel.py - Cloud transcription → Video utilities: uses
core/cloud_transcriber.py - Transcription controls → Translation router: starts translation
ui/panels/transcribe_panel.py - Translation router → Local NLLB: dispatches to
core/translator.py - Translation router → Cloud translation: dispatches to
core/translator.py - Transcription controls → Configuration and keys: reads API key
ui/panels/transcribe_panel.py - Subtitle review → Subtitle data model: edits
ui/subtitle_list.py - Subtitle styling → Subtitle data model: updates styles
ui/panels/style_panel.py - Subtitle styling → Style presets: manages presets
ui/panels/style_panel.py - Subtitle styling → Font catalog: queries fonts
ui/panels/style_panel.py - Video preview → Subtitle renderer: renders subtitles
ui/video_preview.py - Subtitle renderer → Subtitle data model: reads subtitle styles
core/subtitle_renderer.py - Subtitle renderer → Font catalog: resolves fonts
core/subtitle_renderer.py - Export controls → Video subtitle burn: starts video export
ui/panels/export_panel.py - Export controls → ASS subtitle writer: exports ASS
ui/panels/export_panel.py - Export controls → SRT subtitle writer: exports SRT
ui/panels/export_panel.py - Export controls → Text subtitle writer: exports text
ui/panels/export_panel.py - SRT subtitle writer → Subtitle text formatting: formats text
export/srt_writer.py - Text subtitle writer → Subtitle text formatting: formats text
export/txt_writer.py - Video subtitle burn → Subtitle renderer: renders overlays
export/ffmpeg_burner.py - Video subtitle burn → Subtitle data model: reads subtitle data
export/ffmpeg_burner.py - Video subtitle burn → FFmpeg: runs encoding
README.md - Provider settings → Configuration and keys: configures providers
ui/panels/settings_panel.py - Cloud transcription → Cloud speech APIs: requests transcription
- Cloud translation → Cloud translation APIs: requests translation