How yogesh-yogi-s/yogesh-vocal-music-audio works
VMA packages already-separated audio streams in a V1 PCM-WAV container, serves creation/open/info/validation/extraction through a local FastAPI app, and provides synchronized browser playback with independent stream controls. The library also implements a separate V2 opaque-byte container and format-identification registry, but V2 has no application/API workflow. Edges reflect README statements or the supplied excerpts/SOURCE INDEX; frontend-to-HTTP wiring and unsampled V1/V2 internals are not mapped beyond documented behavior.
Main entry points: vma/reader.py V1 Reader · v2/reader.py V2 Reader · main.py FastAPI Routes · vma_service.py Upload Adapter
Components 25
Application
- Browser UI
frontend/js/app.js - FastAPI Routes
backend/app/main.py - Upload Adapter
backend/app/vma_service.py - Temporary Sessions
backend/app/main.py
V1 Audio Container
- WAV Parser
backend/vma/audio.py - V1 Writer
backend/vma/writer.py - V1 Reader
backend/vma/reader.py - V1 Extractor
backend/vma/extractor.py - V1 Validator
backend/vma/validator.py - V1 Layout
backend/vma/format.py - V1 Models
backend/vma/models.py
V2 Opaque Container
- V2 Writer
backend/vma/v2/writer.py - V2 Reader
backend/vma/v2/reader.py - V2 Extractor
backend/vma/v2/extractor.py - V2 Validator
backend/vma/v2/validator.py - Wire Encoding
backend/vma/v2/wire.py - Format Info TLV
backend/vma/v2/format_info.py - V2 Models
backend/vma/v2/models.py - Version Dispatch
backend/vma/dispatch.py
Format Identification
- FORMAT_ID Registry
backend/vma/formats/registry.py - Registry Models
backend/vma/formats/models.py - Format Recognition
backend/vma/formats/identify.py - RIFF/WAVE Check
backend/vma/formats/riff_wave.py - Wave Probe
backend/vma/formats/wave_probe.py
Other components
- User
Connections 35
- User → Browser UI: uses
README.md - Browser UI → FastAPI Routes: requests routes
README.md - FastAPI Routes → Upload Adapter: delegates uploads
backend/app/main.py - FastAPI Routes → Temporary Sessions: stores sessions
backend/app/main.py - Upload Adapter → V1 Writer: creates container
backend/app/vma_service.py - Upload Adapter → V1 Reader: reads container
backend/app/vma_service.py - Upload Adapter → V1 Validator: validates container
backend/app/vma_service.py - Upload Adapter → V1 Extractor: extracts streams
backend/app/vma_service.py - FastAPI Routes → V1 Reader: opens container
backend/app/main.py - FastAPI Routes → V1 Extractor: extracts tracks
backend/app/main.py - V1 Writer → WAV Parser: parses WAV
backend/vma/writer.py - V1 Reader → V1 Layout: uses layout
backend/vma/reader.py - V1 Reader → V1 Models: builds models
backend/vma/reader.py - V1 Writer → V1 Layout: uses layout
backend/vma/writer.py - V1 Writer → V1 Models: uses models
backend/vma/writer.py - WAV Parser → V1 Layout: uses WAV layout
backend/vma/audio.py - WAV Parser → V1 Models: builds audio model
backend/vma/audio.py - V1 Extractor → V1 Reader: reads container
backend/vma/extractor.py - V1 Validator → V1 Reader: validates via read
backend/vma/validator.py - Version Dispatch → V1 Reader: routes V1
backend/vma/dispatch.py - Version Dispatch → V2 Reader: routes V2
backend/vma/dispatch.py - V2 Writer → Wire Encoding: encodes fields
backend/vma/v2/writer.py - V2 Writer → Format Info TLV: serializes TLVs
backend/vma/v2/writer.py - V2 Reader → Wire Encoding: decodes fields
backend/vma/v2/reader.py - V2 Reader → Format Info TLV: parses TLVs
backend/vma/v2/reader.py - V2 Reader → V2 Models: builds models
backend/vma/v2/reader.py - V2 Writer → V2 Models: uses models
backend/vma/v2/writer.py - V2 Extractor → V2 Reader: reads container
backend/vma/v2/extractor.py - V2 Validator → V2 Reader: validates via read
backend/vma/v2/validator.py - FORMAT_ID Registry → Registry Models: uses entries
backend/vma/formats/registry.py - Format Recognition → FORMAT_ID Registry: looks up IDs
backend/vma/formats/identify.py - Format Recognition → RIFF/WAVE Check: recognizes RIFF
backend/vma/formats/identify.py - Wave Probe → FORMAT_ID Registry: uses registry
backend/vma/formats/wave_probe.py - Wave Probe → RIFF/WAVE Check: probes RIFF
backend/vma/formats/wave_probe.py - Wave Probe → Registry Models: returns models
backend/vma/formats/wave_probe.py