How aishwarya0903/beatmap works
BeatMap turns a creator’s song link or recording and edit-type preset into timestamped music-editing guidance. The main path runs from the frontend analysis dashboard through the API routes into the analyzer, which resolves source metadata, obtains AI analysis, shapes the result, and persists it; the frontend presents cuts, shot plans, and other insights. Separate branches provide multilingual trending tracks, track comparison, and saved-analysis history. The README documents these capabilities; relationships involving unsampled frontend wiring are shown only where documented.
Main entry points: bm-analyze.tsx Analysis dashboard · routes.py API routes · analyzer.py Link and audio analyzer · main.py FastAPI app
Components 20
Creator interface
- Analysis dashboard
frontend/src/components/bm-analyze.tsx - Audio recorder
frontend/src/components/recorder.tsx - Analysis results
frontend/src/components/analysis-result.tsx - Cut windows
frontend/src/components/best-cuts-section.tsx - Shot plan
frontend/src/components/shot-plan-section.tsx - Comparison panel
frontend/src/components/compare-tracks.tsx - Recent analyses
frontend/src/components/recent-analyses-section.tsx - Trending tracks
frontend/src/components/bm-trending.tsx
API and contracts
- FastAPI app
backend/app/main.py - API routes
backend/app/api/routes.py - Request and result models
backend/app/api/schemas.py - Runtime settings
backend/app/settings.py
Analysis pipeline
- Link and audio analyzer
backend/app/services/orchestration/analyzer.py - Platform metadata
backend/app/services/metadata - AI analysis
backend/app/services/gemini/client.py - Audio processing
backend/app/services/audio/processor.py - Track comparison
backend/app/services/comparison/compare.py
Music discovery
- Trending provider
backend/app/services/trending/youtube.py
Analysis history
- SQLite analyses
backend/app/services/persistence/db.py
Other components
- Creator
Connections 25
- Creator → Analysis dashboard: submits analysis
README.md - Analysis dashboard → Audio recorder: uses recording
frontend/src/components/bm-analyze.tsx - Analysis dashboard → Comparison panel: opens comparison
frontend/src/components/bm-analyze.tsx - Analysis dashboard → Recent analyses: shows history
frontend/src/components/bm-analyze.tsx - Analysis dashboard → Analysis results: renders result
frontend/src/components/bm-analyze.tsx - Analysis results → Cut windows: renders cuts
frontend/src/components/analysis-result.tsx - Analysis results → Shot plan: renders plan
frontend/src/components/analysis-result.tsx - Analysis dashboard → FastAPI app: sends requests
README.md - Trending tracks → FastAPI app: requests tracks
README.md - FastAPI app → API routes: registers routes
backend/app/main.py - API routes → Request and result models: validates requests
backend/app/api/routes.py - API routes → Link and audio analyzer: dispatches link and audio
backend/app/api/routes.py - API routes → Track comparison: dispatches comparison
backend/app/api/routes.py - API routes → Trending provider: fetches tracks
backend/app/api/routes.py - API routes → SQLite analyses: reads and deletes history
backend/app/api/routes.py - Link and audio analyzer → Platform metadata: fetches platform data
backend/app/services/orchestration/analyzer.py - Link and audio analyzer → AI analysis: requests analysis
backend/app/services/orchestration/analyzer.py - Link and audio analyzer → Audio processing: processes uploads
backend/app/services/orchestration/analyzer.py - Link and audio analyzer → SQLite analyses: saves results
backend/app/services/orchestration/analyzer.py - Track comparison → Link and audio analyzer: analyzes each link
backend/app/services/comparison/compare.py - FastAPI app → SQLite analyses: initializes store
backend/app/main.py - AI analysis → Runtime settings: reads provider keys
backend/app/services/gemini/client.py - Platform metadata → Runtime settings: reads API config
backend/app/services/metadata/youtube.py - Trending provider → Runtime settings: reads API config
backend/app/services/trending/youtube.py - SQLite analyses → Runtime settings: reads database path
backend/app/services/persistence/db.py