How sdijf1521/xb-svcb works
XB-SVCB is a Windows desktop AI singing-conversion and audio-creation workstation. The main workflow imports a song, separates vocals, converts them with a selected model, enhances and mixes the result, then lets the user audition, export, or edit it. The graph also preserves documented branches for realtime conversion, model and music catalogs, plugins, and external HTTP access. Edges follow the README’s architecture and capability descriptions plus visible source references; unsampled service internals are not asserted beyond those documented connections.
Main entry points: bridge.py Bridge API · conversion_service.py Conversion service · engine.py Engine registry · storage.py Local repositories
Components 34
User experience
- Desktop UI
web/src/App.vue - Song creation
web/src/views/create/create.vue - Editor UI
web/src/views/editor/editor.vue - FastAPI server
app/api/http_server.py - Bridge API
app/api/bridge.py - Translations
web/src/i18n/extraPhrases.ts
Application services
- Conversion service
app/application/conversion_service.py - Realtime conversion
app/application/realtime_cover_service.py - Editor service
app/application/audio_editor_service.py - Model management
app/application/model_service.py - Model hub
app/application/model_hub_service.py - Music catalog
app/application/music_service.py - Works library
app/application/work_service.py - Plugin service
app/application/plugin_service.py - System service
app/application/system_service.py
Audio processing
- Engine registry
app/infrastructure/engine.py - So-VITS engine
app/infrastructure/svc_engine.py - RVC engine
app/infrastructure/rvc_engine.py - SeedVC engine
app/infrastructure/seedvc_engine.py - DDSP engine
app/infrastructure/ddsp_engine.py - Vocal separation
app/infrastructure/uvr_tool.py - Vocal enhancement
app/infrastructure/vocal_enhancement.py - Audio tools
app/infrastructure/ffmpeg_tool.py - Editor renderer
app/infrastructure/audio_engine.py - Inference devices
app/infrastructure/inference_device.py - Worker runtime
app/infrastructure/persistent_worker.py - VST3 host
app/infrastructure/juce_vst3_host.py
Models and data
- Local repositories
app/infrastructure/storage.py - User data paths
app/infrastructure/paths.py - Runtime config
app/config.py
External capabilities
- ModelScope
- Music providers
Other components
- Desktop user
- HTTP client
Connections 39
- Desktop user → Desktop UI: uses
- Desktop UI → Bridge API: calls
- HTTP client → FastAPI server: submits requests
- FastAPI server → Bridge API: reuses facade
app/api/http_server.py - Bridge API → Conversion service: dispatches
- Bridge API → Model management: dispatches
- Bridge API → Editor service: dispatches
- Bridge API → Plugin service: dispatches
- Song creation → Bridge API: submits tasks
- Editor UI → Bridge API: calls editor API
- Conversion service → Vocal separation: separates vocals
app/application/conversion_service.py - Conversion service → Engine registry: selects framework
app/application/conversion_service.py - Engine registry → So-VITS engine: routes inference
- Engine registry → RVC engine: routes inference
- Engine registry → SeedVC engine: routes inference
- Engine registry → DDSP engine: routes inference
- Conversion service → Vocal enhancement: enhances vocals
app/application/conversion_service.py - Conversion service → Audio tools: mixes audio
app/application/conversion_service.py - Conversion service → Local repositories: stores work state
app/application/conversion_service.py - Editor service → Editor renderer: renders projects
app/application/audio_editor_service.py - Editor service → Local repositories: stores projects
app/application/audio_editor_service.py - Editor renderer → VST3 host: uses effects host
app/application/audio_editor_service.py - Realtime conversion → Vocal separation: separates vocals
app/application/realtime_cover_service.py - Realtime conversion → Engine registry: converts vocals
app/application/realtime_cover_service.py - Realtime conversion → Audio tools: remixes audio
app/application/realtime_cover_service.py - Realtime conversion → Local repositories: reads model data
app/application/realtime_cover_service.py - Model management → Local repositories: persists models
app/application/model_service.py - Model hub → Local repositories: updates model data
app/application/model_hub_service.py - Model hub → ModelScope: searches and transfers
- Music catalog → Music providers: searches catalog
- Works library → Local repositories: manages works
- Engine registry → Worker runtime: launches workers
- So-VITS engine → Inference devices: selects device
app/infrastructure/svc_engine.py - RVC engine → Inference devices: selects device
app/infrastructure/rvc_engine.py - SeedVC engine → Inference devices: selects device
app/infrastructure/seedvc_engine.py - User data paths → Runtime config: uses data paths
app/infrastructure/paths.py - Conversion service → User data paths: uses work paths
app/application/conversion_service.py - Plugin service → Local repositories: uses plugin data
- Desktop UI → Translations: loads translations