Singalong

A full-stack singing practice application with real-time pitch detection and feedback.

Architecture

• Backend (/backend) - FastAPI service for audio processing and pitch analysis
• Frontend (/frontend) - React + TypeScript web application for practice sessions

Quick Start

Backend

cd backend
pip install -r requirements.txt
uvicorn app.main:app --port 8001

Frontend

cd frontend
npm install
npm run dev

Features

• Upload songs for practice
• Real-time pitch visualization
• Lyrics synchronization
• Vocal separation using BS-RoFormer
• Pitch scoring and feedback
• Progress tracking

Development

Both services are configured to work together:

• Frontend runs on http://localhost:5173 (or 5174 if 5173 is in use)
• Backend runs on http://localhost:8001
• Database: SQLite at backend/singalong.db