How airiharuki/harmonic-studio-v2 works
VibeCoded Music Lab is a browser-based music theory and audio-workflow app. Users can calculate pitch shifts and explore key relationships, generate and play chord loops, or load a track for download, analysis, and stem separation. The React app coordinates these workflows; a server provides track and audio endpoints, while browser-side analysis and audio components handle playback and results. The README documents capabilities whose implementation was not sampled, so those branches are represented at the documented subsystem level; server internals beyond the shown security helper remain unverified.
Main entry points: App.tsx Studio App · server.ts Audio API · instantAnalysis.ts Track Analysis · RecentTracks.tsx Recent Tracks UI
Components 19
Music Theory
- Pitch Calculator
src/PitchShifter.tsx - Circle of Fifths
src/CircleOfFifths.tsx
Loop Studio
- Progression Generator
src/chordProgressions.ts - Piano Roll
src/components/PianoRoll.tsx - Lyrics Display
public/lyrics.txt
Track Analyzer
- Track Analysis
src/lib/instantAnalysis.ts - Stem Separation
server.ts
Audio Playback
- Waveform Player
src/components/WaveformPlayer.tsx - Stem Mixer
src/components/StemMixer.tsx
App Services
- Studio App
src/App.tsx - Audio API
server.ts - Path Protection
server/security.ts - Recent Tracks UI
src/components/RecentTracks.tsx - Recent Track Store
lib/recentTracks.ts
Other components
- Musician
- Track Sources
- Essentia.js
- Separation Models
- Electric Piano SoundFont
public/epiano.sf2
Connections 20
- Musician → Studio App: uses
README.md - Studio App → Pitch Calculator: shows
src/App.tsx - Studio App → Circle of Fifths: shows
src/App.tsx - Studio App → Progression Generator: generates with
README.md - Studio App → Piano Roll: renders
src/App.tsx - Studio App → Lyrics Display: loads
README.md - Studio App → Track Analysis: runs
src/App.tsx - Studio App → Audio API: requests track info
src/App.tsx - Track Sources → Audio API: provides audio
README.md - Audio API → Stem Separation: dispatches separation
server.ts - Stem Separation → Separation Models: uses models
README.md - Stem Separation → Stem Mixer: provides stems
- Studio App → Essentia.js: analyzes audio
README.md - Track Analysis → Essentia.js: estimates BPM and key
src/lib/instantAnalysis.ts - Studio App → Waveform Player: renders
src/App.tsx - Studio App → Stem Mixer: renders
src/App.tsx - Studio App → Electric Piano SoundFont: plays loops
src/App.tsx - Studio App → Recent Tracks UI: shows history
src/App.tsx - Recent Tracks UI → Recent Track Store: reads and updates
src/components/RecentTracks.tsx - Audio API → Path Protection: uses safeguards
server.ts