# Unnoted

> Learn to play music just like you learn your mother language. Listen, repeat, express. No theories, no notation.

Unnoted (https://unnoted.app) is an interactive web application designed to help people learn music naturally by ear and vocal/instrumental imitation. Rather than requiring users to study abstract sheet music or complex music theory beforehand, Unnoted trains the brain's innate musical ear through dynamic call-and-response and continuous play-along practice.

## Core Philosophy
- **Natural Acquisition**: Just as children learn their mother language by listening and babbling before reading letters, musicians develop true fluency by listening and echoing melodies before reading sheet music notation.
- **Listen & Repeat**: The system plays an expressive, organically phrased musical challenge. The user echoes it on their instrument or voice.
- **No Theories, No Notation**: Zero note names, zero staff lines, zero barrier to entry. Just the pure joy and intuition of musical sound.

## Features & Modes
- **Play Along Mode**: Melodies loop rhythmically with audio playback and real-time resonance visualization. An optional auto-play mode cycles through phrases seamlessly.
- **Listen & Repeat Mode**: Structured call-and-response practice with optional real-time microphone pitch feedback and compliments for accurate replication.
- **Progressive Levels**:
  - Level 1 (Gentle): 2-3 notes, slow and spacious.
  - Level 2 (Melodic): 4-5 notes, singable motifs.
  - Level 3 (Flourish): 6-8 notes, natural expressive contours.
  - Level 4 (Challenging): 8-10 notes, intricate phrasing.
- **10 Rich Instruments**: Piano, Acoustic Guitar, Flute, Violin, Cello, Saxophone, Trumpet, Clarinet, Vibraphone, Electric Piano.
- **8 Musical Genres**: General, Classical, Folk, Jazz, Blues, Pop, Celtic, Ambient.
- **Favorites & Offline ABC/MIDI Export**: Melodies can be favorited, replayed, and downloaded as MIDI or ABC notation at any time.

## URL Structure
- Main Web Application: https://unnoted.app/
- Practice Challenge API: POST https://unnoted.app/api/practice/challenge
- Prefetch API: POST https://unnoted.app/api/practice/prefetch
- Synthesized Audio: https://unnoted.app/generated/{filename}.mp3
- MIDI Files: https://unnoted.app/generated/{filename}.mid

## Technical Details
- Web application running as a fast, accessible PWA.
- Works in all modern desktop and mobile web browsers without plugins or downloads.
- Real-time Web Audio API and WebAssembly/HTML5 Canvas pitch and sound visualization.
