Purpose

This app is built for vocal and melodic pitch training. It tracks live microphone input, maps notes to Western + Sargam, and provides visual feedback for tuning, stability, and structured exercise practice.

Quick Start

• Click Start and grant microphone access.
• Select your tonic (Sa) in controls.
• Sing a steady note and watch frequency, note, Sargam, cents meter, and pitch timeline.
• Use Practice mode for focused exercise training with target-note guidance.
• Open Settings for quick controls, exercise difficulty/octave, and display options.

Readout & Timeline Specifications

• Frequency is shown in Hz with 2-decimal precision.
• Nearest note + Sargam label update continuously.
• Cents meter range is -50¢ to +50¢; center means in tune.
• Timeline displays pitch history with silence gaps not connected.
• Auto-Tune guide line appears when Auto-Tune Visualization is enabled.
• Tone estimates timbre quality from harmonic balance and breath/noise content.
• Stability scores recent cents jitter (higher means steadier pitch).
• Musician DNA learns per-swara intonation tendency (sharp/flat bias).

Controls & Settings

• Sa: tonic root used for Sargam mapping.
• Low Cut (50-200Hz): high-pass filter to suppress low-frequency noise.
• Gate (0.001-0.050): silence threshold; higher value rejects weak signals.
• Clarity (0.20-0.80): stricter pitch confidence threshold.
• Timeline Duration (3-15s): visible pitch history length.
• Smoothing (0.0-0.9): stabilizes pitch display; higher is smoother but slower.
• FPS Limit: rendering speed/performance balance.
• Auto-Detect Tonic (Sa): when enabled, the app can set Sa from a stable detected note.
• Show Formant Analysis: visible in Advanced Analysis → Spectrum.

Advanced Analysis

• Waveform: raw time-domain mic signal for attack/sustain behavior.
• Harmonics: strongest overtone peaks in the current sound.
• Frequency Spectrum: distribution of energy across frequencies.
• Intonation Drift Heatmap: time vs Sargam map colored by cents drift (flat/in-tune/sharp).

Exercise Specifications

• Chromatic / Sargam / Interval / Octave Switch / Sustained: guided pitch exercises with real-time target tracking.
• Exercise Octave: choose Octave 3 (C3), Octave 4 (C4), or Octave 5 (C5) as base note for sequence/interval exercises.
• Sustained Pitch: hold one stable note; required hold duration depends on selected difficulty.
• Difficulty presets: Beginner (easier tolerance, shorter holds), Normal (balanced), Strict (tighter tolerance, longer holds).
• Target tolerance uses cents-based pitch matching (Normal mode is around ±20¢).
• Guidance prompts include: go higher/lower, tune up/down, and next target note.
• Use Play Targeted Note to hear the target pitch and Restart to retry quickly.
• Exercise cards store best stats per context (exercise + difficulty + octave + Sa).

Recording & Data

• Use Record to capture live pitch sessions.
• Session list supports playback, CSV + timeline graph export, and delete.
• Export All Sessions downloads an Excel-compatible CSV with full note details.

Privacy & Security

• This app runs in the browser on your current machine only.
• Your microphone stream is used only for real-time analysis and is not uploaded by the app.
• Saved sessions are stored only in this browser profile on this machine (localStorage), unless you export them.
• No practice data is shared externally by default.

Troubleshooting & Best Results

• Practice in a quiet room and keep constant mic distance.
• If pitch flickers, increase Gate slightly or reduce background noise.
• If detection feels too strict, reduce Clarity threshold.
• Use noise calibration before practice for cleaner gating.
• If response feels slow, reduce Smoothing and/or increase FPS limit.

Keyboard Shortcuts

Space Start/Stop Mic R Record P Practice Mode H Help Esc Close/Exit