How weewrr/subtitletool works
Subtitle Tool is a desktop/browser subtitle workbench. The main workflow is to open media and subtitles, edit and review timing, then export; users can also request recognition, translation, dubbing, hard-subtitle rendering, and waveform views. The Vue UI communicates with a Flask API, whose route and service layers provide these capabilities. The README documents the major features and API; sampled source confirms selected wiring, while some feature-specific backend links remain unverified.
Main entry points: __init__.py Flask application · App.vue Subtitle workbench · spark_tts_service.py TTS generation · transcription.py Recognition routes
Components 24
Editing Workbench
- Subtitle workbench
frontend/src/App.vue - Subtitle editing
frontend/src/stores/subtitleStore.js - API client
frontend/src/services/ApiService.js
Flask API
- Flask application
backend/__init__.py - Settings
backend/config/settings.py - Subtitle routes
backend/routes/subtitle.py - Recognition routes
backend/routes/transcription.py - Translation routes
backend/routes/translation.py - Spell-check routes
backend/routes/spell_check.py - Dubbing routes
backend/routes/tts.py - Media routes
backend/routes/hard_subtitle.py - Waveform routes
backend/routes/waveform.py - Temporary files
backend/utils/temp_dir.py
Language Services
- Recognition jobs
backend/services/transcription_service.py - Translation engines
backend/services/translation_service.py - Spell checking
backend/services/spell_check_service.py - Whisper engines
backend/services/whisper_service.py
Speech Engines
- TTS generation
backend/services/spark_tts_service.py - Spark-TTS model
Spark-TTS/cli/SparkTTS.py - Qwen3-TTS model
Qwen3-TTS/qwen_tts/inference/qwen3_tts_model.py - Audio alignment
tts_alignment.py
Other components
- Subtitle editor
- External AI services
- FFmpeg tools
Connections 29
- Subtitle editor → Subtitle workbench: edits media
README.md - Subtitle workbench → Subtitle editing: manages edits
frontend/src/App.vue - Subtitle workbench → API client: requests features
- API client → Flask application: calls API
README.md - Flask application → Subtitle routes: registers routes
backend/__init__.py - Flask application → Recognition routes: registers routes
backend/__init__.py - Flask application → Translation routes: registers routes
backend/__init__.py - Flask application → Spell-check routes: registers routes
backend/__init__.py - Flask application → Dubbing routes: registers routes
backend/__init__.py - Flask application → Media routes: registers routes
backend/__init__.py - Flask application → Waveform routes: registers routes
backend/__init__.py - Recognition routes → Recognition jobs: starts jobs
- Recognition jobs → Whisper engines: dispatches engine
backend/services/transcription_service.py - Translation routes → Translation engines: submits translation
- Translation engines → External AI services: uses providers
README.md - Spell-check routes → Spell checking: checks text
- Dubbing routes → TTS generation: starts generation
backend/routes/tts.py - TTS generation → Spark-TTS model: generates speech
- TTS generation → Qwen3-TTS model: selects engine
- TTS generation → Audio alignment: aligns audio
- Dubbing routes → Temporary files: uses temp files
backend/routes/tts.py - Recognition routes → Temporary files: uses temp files
- Media routes → FFmpeg tools: renders subtitles
README.md - Waveform routes → FFmpeg tools: extracts waveform
README.md - Subtitle editing → Subtitle routes: imports exports
README.md - Subtitle workbench → Translation routes: translates subtitles
README.md - Subtitle workbench → Spell-check routes: checks spelling
README.md - Subtitle workbench → Media routes: renders hard subtitles
README.md - Subtitle workbench → Waveform routes: requests waveform
README.md