How buxuku/smartsub works
SmartSub is an Electron desktop tool for producing, editing, translating, voicing, and exporting subtitles and media. Its main user workflow runs from media download or local-file submission through transcription, translation, proofreading, optional dubbing, and final video/subtitle export. The graph also includes the documented AI assistant, MCP/CLI automation, resource management, and media toolbox. Some subsystem links rely on README descriptions because their implementation files were not sampled; those links are cited as documented relationships.
Main entry points: Layout.tsx Desktop workspace · taskProcessor.ts Task orchestration · registry.ts Speech transcription · audioPipeline.ts TTS and dubbing
Components 18
Desktop workspace
- Desktop workspace
renderer/components/Layout.tsx
Subtitle processing
- Task orchestration
main/helpers/taskProcessor.ts - Speech transcription
main/helpers/engines/registry.ts - Subtitle translation
main/translate/index.ts - Subtitle proofreading
renderer/components/proofread/ProofreadEditor.tsx
Media production
- Video download
main/helpers/videoDownload/pipeline.ts - TTS and dubbing
main/helpers/dubbing/audioPipeline.ts - Voice cloning
main/helpers/voiceClone/cloneAudioPipeline.ts - Subtitle composition
renderer/components/subtitleMerge/SubtitleMergePanel.tsx - Media toolbox
main/helpers/toolbox/ipcToolboxHandlers.ts
AI and automation
- AI assistant
main/assistant/runtime.ts - MCP and CLI
main/automation/server.ts
Engines and state
- Engine resources
renderer/components/resources/EngineModelTab.tsx - Python engine runtime
main/helpers/pythonRuntime/index.ts - Local task and settings state
main/helpers/workItemStore.ts
Other components
- User
- External AI agent
- Optional cloud services
Connections 24
- User → Desktop workspace: uses
README.md - Desktop workspace → Video download: starts download
README.md - Desktop workspace → Task orchestration: submits tasks
README.md - Video download → Task orchestration: provides media
README.md - Task orchestration → Speech transcription: dispatches recognition
main/helpers/taskProcessor.ts - Task orchestration → Local task and settings state: updates work items
main/helpers/taskProcessor.ts - Task orchestration → Subtitle translation: runs translation
README.md - Task orchestration → Subtitle proofreading: prepares review
README.md - Desktop workspace → Subtitle proofreading: edits subtitles
README.md - Desktop workspace → AI assistant: opens assistant
README.md - AI assistant → Task orchestration: invokes tools
README.md - External AI agent → MCP and CLI: calls tools
README.md - MCP and CLI → Task orchestration: dispatches tasks
README.md - Desktop workspace → TTS and dubbing: starts dubbing
README.md - TTS and dubbing → Voice cloning: uses cloned voice
main/helpers/voiceClone/cloneAudioPipeline.ts - Desktop workspace → Subtitle composition: configures export
README.md - Desktop workspace → Media toolbox: runs media tools
README.md - Desktop workspace → Engine resources: configures engines
README.md - Engine resources → Python engine runtime: manages runtime
- Speech transcription → Python engine runtime: runs Python engine
- Speech transcription → Optional cloud services: uses cloud ASR
README.md - Subtitle translation → Optional cloud services: uses translation APIs
README.md - TTS and dubbing → Optional cloud services: uses cloud TTS
README.md - Subtitle composition → Local task and settings state: stores work items