Skip to content

Latest commit

 

History

98 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

preview Download

🎼 HarmonicField — Interval Ear Training Reimagined

Welcome to HarmonicField, a fresh take on interval ear training that transforms how musicians internalize the language of sound. Where traditional trainers stop at simple A/B comparisons, HarmonicField builds a living soundscape that adapts to your listening habits, fatigue levels, and genre preferences.

🧠 Why HarmonicField Exists

Most interval trainers treat your ears like a multiple-choice quiz machine. You hear a fifth, you guess a fifth, you move on. But music doesn’t work that way—intervals live inside melodies, chord progressions, and ambient noise. HarmonicField wraps interval recognition in real musical contexts, pulling sample phrases from classical, jazz, electronic, and folk traditions so that you're not just identifying abstract pitches—you’re recognizing the emotional fingerprint of each interval.

Think of it as a gym for your inner ear, but instead of lifting weights, you’re lifting melodic fragments, harmonic colors, and rhythmic ornaments.

🌱 Core Philosophy: Context-First Listening

The standard approach treats intervals as isolated events. HarmonicField believes intervals are relational. A perfect fourth sounds different when it arrives from below versus above, when it’s part of a descending bassline, or when it’s processed through a vintage synth filter. Our engine layers your training session with ambient backing textures (optional), allowing you to hear intervals the way you’d hear them on stage, in a studio, or through a practice amp—not in a sterile vacuum.


🎛️ Feature Matrix: What Makes HarmonicField Distinct

1. Adaptive Difficulty Lattice 🕸️

The trainer doesn’t just increase speed. It builds a multidimensional lattice of difficulty: interval size, tonal context, instrumentation, tempo, and reverb depth. Each session unlocks a unique combination, so you never plateau into routine.

2. Genre-Aware Soundbank 🎸

Choose from seven sound palettes—acoustic piano, nylon guitar, synthwave pad, orchestral strings, analog tape, pipe organ, and even a 8-bit chiptune mode. Each instrument brings unique overtones that challenge your ear differently. A major third on a pipe organ behaves nothing like one on a 8-bit square wave.

3. Melodic Phrase Builder 🎵

Instead of random intervals, HarmonicField inserts your target interval into a short, 3–5 note phrase. You hear the interval as part of a musical sentence, then you’re asked to identify it. This mimics real-world listening, where intervals appear mid-phrase, often with passing tones.

4. Fatigue-Aware Session Engine 🧠

Your ears get tired. Our algorithm tracks your response latency, accuracy trends, and even your headphone volume (via web audio API). When it detects listening fatigue, it shifts the session to harmonic awareness mode—slower, longer tones, with fewer test items—or suggests a break. It’s a coach that cares about your auditory health.

5. Micro-Interval & Just Intonation Module 🎼

Beyond standard equal temperament, HarmonicField includes a microtonal lab where you can compare quarter-tones, Pythagorean thirds, and septimal commas. This is a premium module for composers exploring non-Western scales or barbershop harmony.

6. Progress Visualization Forest 🌳

Track your improvement as a growing virtual forest. Each mastered interval category grows a unique tree species. Missed intervals produce saplings in need of care. It’s a visceral, non-numeric way to see your auditory landscape expand over months.

7. Offline-First Architecture 📡

All audio samples are pre-generated and bundled. The app works in airplane mode, in tunnels, or at that remote cabin without Wi-Fi. Your progress syncs when connectivity returns.

8. Multilingual Interface 🌍

The UI is available in English, Spanish, German, French, Japanese, and Portuguese. The audio itself is language-agnostic—intervals speak a universal tongue.

9. Collaborative Ear Gym 👥

Create or join practice circles. You can share custom phrase banks, challenge friends to “interval duels,” or contribute your own recorded instrument samples to the community soundbank (with moderation).

10. 24/7 Support & Community Forums 🕓

Have a question at 3 AM about the difference between augmented fourth and diminished fifth? Our support docs are extensive, and the community forum hosts a dedicated section for audio theory Q&A. Monthly live Q&A sessions with ear-training specialists (rotating schedule, always announced in advance).


🛠️ Technology Stack (The Unseen Machinery)

  • Frontend: Vanilla JavaScript with Web Audio API for real-time synthesis and playback. No heavy frameworks—keeps the bundle lean and mobile-friendly.
  • Persistence: localStorage for progress, IndexedDB for user-generated phrase banks.
  • Responsive UI: Fully adaptive layout that works from a 320px phone screen to a 4K desktop monitor. Touch-friendly buttons with haptic-like visual feedback.
  • Accessibility: High-contrast modes, screen-reader friendly labels, and adjustable target sizes for motor-impaired users.

📱 Responsive UI & Mobile Optimization

HarmonicField is designed for pocket practice—you can train while waiting for the bus, during studio downtime, or in a park with birdsong as your ambient backdrop. The entire interface collapses into a one-hand thumb zone. Swipe gestures allow bypass of intervals, long-press for repeat, and double-tap for hint. The audio latency is tuned for mobile Safari and Chrome, falling consistently below 20ms.


🌱 Getting Started (The Non-Technical Way)

  1. Open the Web App — No account required for basic training. Session data stays on your device.
  2. Calibrate Your Voice — Optional: Sing along with the intervals, and the app uses mic input to assess your pitch-matching skills.
  3. Choose Your Environment — Select background texture (silence, cafe murmur, vinyl crackle, or ocean waves) and instrument palette.
  4. Start Your First Phrase — You’ll hear a 3-note phrase. The target interval is embedded. Tap the interval you heard. The forest begins to grow.

🧪 The Science of Ear Training (A Brief Note)

Cognitive research suggests that distributed practice—short, frequent sessions—beats marathon listening. HarmonicField’s default session length is 7 minutes. The algorithm schedules micro-review intervals based on a spaced-repetition heuristic adapted from linguistics. You’ll be asked to recall intervals you haven’t heard in 2 days, then 5 days, then 12 days. This logarithmic spacing optimizes long-term retention.


🧩 Comparison to Other Trainers

Feature Typical Trainers HarmonicField
Interval context Single tones Musical phrases
Instrument options Piano only 8 varied palettes
Fatigue adaptation None Proactive mode shifts
Microtonal support Rare Built-in lab
Visual feedback Score bar Living forest metaphor
Offline availability Often cloud-dependent Fully offline

💡 Usage Scenarios

  • Jazz Improvisers: Use the “tension-release” phrase bank to internalize how sharp fifths resolve into major thirds within a ii–V–I context.
  • Electronic Producers: Train your ear to hear detuned sawtooth intervals, using the chiptune and synthwave palettes to mimic real production chains.
  • Classical Students: The orchestral string palette highlights the natural phasing and bow noise differences that make intervals feel fuller.

🧰 Customization & Advanced Settings

  • Tempo Scaling: From 40 BPM (very slow, analytical) to 180 BPM (speed recognition).
  • Overton Density: Adjust the number of harmonics to simulate different room acoustics.
  • Root Key Rotation: Cycle through all 12 keys in circle-of-fifths order for thorough transposition training.
  • Answer Interface: Choose between tapping virtual interval buttons, singing into the mic for pitch matching, or typing in solfège names (do-re-mi).

🛡️ Privacy & Data Policy

HarmonicField stores all data locally. No user accounts, no server-side tracking, no cookies. The optional collaboration mode only exchanges encrypted session hashes, never your personal progress details. Your forest is your own sanctuary.


🤝 Contribution Guidelines (For the Musically Inclined Developer)

We welcome contributions, but we’re picky. We want code that:

  • Keeps the bundle size under 150KB gzipped (currently at 112KB).
  • Uses no external audio dependencies—all synthesis in-house.
  • Passes the “flight mode” test: the app must function with zero network requests.
  • Respects the web audio best practices for low-latency playback.

If you’re building a new sound palette, remember: each instrument must be defined as a set of harmonic coefficients and amplitude envelopes, not pre-recorded samples (to keep the bundle lean). See docs/SYNTH_DESIGN.md for the full spec.


🪪 License

HarmonicField is released under the MIT License.

You are welcome to use, modify, and distribute this software in personal or commercial music education tools, provided you retain the original copyright notice. The MIT license grants you the freedom to build your own ear-training platform on top of our foundation, but we ask that you attribute the original source.

See the full license text in LICENSE.


⚠️ Disclaimer

HarmonicField is a practice aid, not a substitute for formal ear-training instruction. No app can replace a human teacher’s feedback on your vocal intonation or your instrument-specific technique. The fatigue detection algorithm is heuristic, not medical—if you experience ear pain, dizziness, or ringing, stop using headphones immediately and consult a professional.

The microtonal module is educational only and does not imply any specific aesthetic preference for non-equal temperament systems. All musical examples are generated algorithmically and may occasionally produce dissonant combinations that some listeners find unpleasant—lower the volume or switch instrument palettes if uncomfortable.


🗺️ Roadmap (2026 Aspirations)

  • Spring 2026: Community phrase bank submission portal with peer review.
  • Summer 2026: Internationalization push for Korean, Hindi, and Arabic.
  • Autumn 2026: WebXR integration for VR ear-training environments.
  • Winter 2026: Collaborative live session mode where two users practice duet intervals in real-time (requires WebRTC).

❓ Frequently Asked Questions

Q: Do I need a login? A: No. Open the HTML file or host it locally. Your progress lives in your browser’s storage.

Q: Can I use this to train absolute pitch? A: No, Interval-Trainer is for relative pitch (the relationship between two notes). It does not help you identify a single pitch without external reference.

Q: Why is the forest growing so slowly? A: The forest visual is intentionally recalibrated every 30 days. Early on, trees change quickly (each correct answer adds growth points). In months 2–3, the growth curve flattens, and an old tree may shed leaves when you miss a previously-mastered interval type. This mirrors real memory decay—use it to target your weak spots.


HarmonicField: Your inner ear already knows the notes. We just teach it to listen.

About

Best Music Ear Training Tool 2026: Master Intervals Fast on Mobile

Topics

Resources

Stars

55 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages