How tinaishe-dr/virtual_mbira works
Virtual Mbira is a browser-based instrument and loop studio. Players choose either instrument, strike keys with mouse, keyboard, or touch, tune and shape the voice, then record and manage layered loops for playback or WAV export. The main runtime responsibilities visible in the excerpts are input/session orchestration, musical mapping and session encoding, and Web Audio synthesis/rendering; the README documents additional gallery, cultural information, and media capabilities. Source excerpts do not show all UI wiring, so undocumented connections are omitted.
Main entry points: app.js Recording and layers · audio.js Voice playback · index.html Instrument, gallery, context · server.js Local media server
Components 12
Playing instruments
- Instrument UI
app.js - Tuning and events
music.js
Loop studio
- Recording and layers
app.js - Saved session
- WAV export
audio.js
Audio engine
- Voice playback
audio.js - Reference sound banks
reference-bank.js - Nyunga sound bank
nyunga-bank.js
Media and context
- Instrument, gallery, context
index.html - Performance video
assets/mbira-performance.mp4 - Local media server
server.js
Other components
- Player
Connections 15
- Player → Instrument UI: plays and configures
README.md - Instrument UI → Tuning and events: maps pitches
app.js - Instrument UI → Voice playback: plays notes
README.md - Instrument UI → Recording and layers: records and controls
app.js - Recording and layers → Tuning and events: mixes events
README.md - Recording and layers → Saved session: saves and restores
app.js - Recording and layers → Voice playback: plays mix
README.md - Recording and layers → WAV export: exports mix
README.md - WAV export → Voice playback: renders offline
audio.js - Voice playback → Reference sound banks: decodes voice
audio.js - Voice playback → Nyunga sound bank: decodes voice
audio.js - Instrument, gallery, context → Performance video: presents video
README.md - Player → Instrument, gallery, context: explores
README.md - Player → Local media server: requests page and media
README.md - Local media server → Performance video: serves ranges
server.js