How mherick/voicestudio works
VoiceStudio is a local-first desktop studio for voice creation and audio/video production, with optional remote workers and external integrations. The primary workflow is to choose or create a voice, provide text or media, generate or transform speech, then review and export the result. The graph preserves the README’s other major workflows and shows the Electron UI, API boundary, model engines, and persistence layer. Some backend capabilities are documented or named in the tree but their internal wiring was not sampled, so those links are intentionally conservative.
Main entry points: main.py HTTP API · app.tsx Electron workspace · clone-page.tsx Voice cloning · design-page.tsx Voice design
Components 22
Desktop experience
- Electron workspace
electron/src/renderer/src/app.tsx - Engine catalogue
electron/src/shared/components/EngineCompatibilityMatrix.jsx
Voice creation
- Voice cloning
electron/src/renderer/src/features/clone/clone-page.tsx - Voice design
electron/src/renderer/src/features/design/design-page.tsx - Voice profiles
backend/api/routers/profiles.py - Speech generation
electron/src/renderer/src/features/clone/script-panel.tsx - Generation API
backend/api/routers/generation.py
Audio production
- Video dubbing
electron/src/renderer/src/features/dub/dub-page.tsx - Dub processing
backend/services/dub_pipeline.py - Dub endpoints
backend/api/routers/dub_core.py - Dictation
backend/api/routers/dictation.py - Stories and books
electron/src/renderer/src/features/longform/longform-page.tsx - Audiobook service
backend/services/audiobook.py - Batch jobs
electron/src/renderer/src/features/batch/batch-page.tsx
Runtime platform
- HTTP API
backend/main.py - TTS engines
backend/services/tts_backend.py - Engine discovery
backend/api/routers/engines.py - Project storage
backend/core/db.py - Remote workers
backend/worker/pool.py
Integrations
- API and MCP
backend/mcp_server.py
Other components
- User
- Optional services
Connections 27
- User → Electron workspace: uses
- Electron workspace → Voice cloning: opens
- Electron workspace → Voice design: opens
- Electron workspace → Speech generation: opens
- Electron workspace → Video dubbing: opens
- Electron workspace → Stories and books: opens
- Electron workspace → Batch jobs: opens
- Voice cloning → HTTP API: requests
- Voice design → HTTP API: requests
- Speech generation → HTTP API: requests
- HTTP API → Voice profiles: routes requests
- HTTP API → Generation API: routes requests
- Generation API → TTS engines: generates speech
- HTTP API → Engine discovery: routes requests
- Engine catalogue → Engine discovery: lists engines
- Video dubbing → Dub endpoints: submits media
- Dub endpoints → Dub processing: runs dubbing
- Dub processing → TTS engines: synthesizes lines
- Electron workspace → Dictation: requests transcription
- Stories and books → HTTP API: requests generation
- HTTP API → Audiobook service: routes book work
- Batch jobs → HTTP API: queues jobs
- HTTP API → Project storage: persists state
- HTTP API → Remote workers: dispatches work
- HTTP API → API and MCP: exposes tools
- API and MCP → Optional services: connects optionally
- Remote workers → Optional services: uses remote compute