Music Theory Toy Box

Music Theory Toy Box: A Laboratory of Sound Geometry, Physics, and Intuition

1. Preface: Tactile Music Theory
Music Theory Toy Box is an interactive music theory app distilling musical systems into visual models. From Undertone symmetry to Jazz voice-leading, manipulate sound via pure frequency. Feel the physical necessity of harmony, prioritizing ear training and intuition over traditional textbooks.

2. Content Structure & Smart Navigation
- 27 Interactive Modules: A massive sound design playground of musical logic and physics.
- Custom Dashboard: Long-press any module to create shortcuts on the main screen.
- 17 Fundamental Modules: Ad-free forever. Focus purely on core music theory concepts.
- 10 Advanced Experimental Modules: Ad-supported access to deep generative music tools and acoustic theory.
- Premium Unlock: Single in-app purchase removes all ads permanently.

3. Core Concept & Use Cases
- Sandbox Exploration: Direct interaction with intervals, scales, and chord progressions.
- Psychoacoustics: Study frequency ratios, microtonality, and human perception.
- Creative Logic: Visualize structures like Negative Harmony and Mirror Symmetry.
- Physics as Play: Mathematical formulas transformed into a tactile audio playground.
- Professional Reference: Tag-filtered focus on Jazz harmony, Baroque counterpoint, or Sound Physics.

4. Interactive Modules: Fundamentals
- Plucked String Simulator [NEW]: Physical acoustics simulation of stringed instruments.
- Over/Undertone Symmetry: Explore mathematical mirrors of harmonic series.
- Circle of Fifths: Geometric UI with Gaussian "Harmonic Blur" for resonance and scale visualizer.
- Tonnetz: 2D spatial exploration of triad resonance and chord progression visualizer.
- Tetrachord & Mode Helix: Spiral UI for visualizing color-coded modes and scales.
- Counterpoint Engine: Real-time Bach-style polyphony generator with toggleable rules.
- Functional & Negative Harmony: Visual chord roles and mirror substitutions.
- Scale Morpher: Microtonal scale tuner for historical and experimental temperaments.
- Speech-Tone Lab: Microtonal deconstruction via "Talking Piano" synthesis.

5. Interactive Modules: Advanced Experimental Suite
- Geometry Sound [NEW]: Geometric synth—draw shapes to play; polygon side lengths yield chords, line lengths play single notes.
- Pitch-Visual Conversion Lab: Map audio frequencies to light across 40 octaves (2^40).
- Hum-to-Harmony: Transcribe humming to ABC notation with stylistic chord harmonization.
- Gamelan Generator: Explore Balinese Kotekan patterns and "Ombak" beating acoustics.
- Speech-Tone to Music: Map vocal inflections to scales (e.g., "fear" to diminished scale).
- N-Tone x N-TET: Microtonal serialism across pitch divisions like 19-TET or 31-TET.
- Bop Idiom x Counterpoint: Master II-V-I and Coltrane Changes via tonal gravity.
- World Mode Builder: Explore global scales like Raga, In Scale, or non-octave scales.
- Negative Harmony Keyboard: Interactive instrument for instant cadence comparison.
- Polyrhythm Chord Converter: Convert rhythmic ratios into pitch and harmony.
- Genetic Phrase Lab: Generative music melody generator via selection and mutation.

6. Technical Specifications
- Expressive Synth Engine: Upgraded with "Attack Noise Config" for realistic picking nuances via reverb routing and velocity modulation.
- Low-Latency Engine (Oboe C++): Minimized audio latency for immediate response.
- Waveform Selection: Sine, Triangle, Square, and Sawtooth for harmonic analysis.
- Generative Logic: Real-time harmonization and Chord-Scale theory integration.
- Psychoacoustic Integration: Shepard tones for continuous scale and spectrum loops.

7. Developer Note: Mapping the Boundary
By removing production distractions, we focus on the link between acoustics and perception. Touch the mathematical fabric of sound design, find new expressive possibilities in pure frequency, and rediscover timbre at its limits.