About this project

ScaleForge is an interactive ear-training and scale-practice application for pianists, driven by live MIDI input. Rather than a static reference chart, it listens to what you play and responds in real time, aiming to turn scale patterns into muscle memory. Core capabilities described in the README: - Live MIDI feedback: recognizes USB or Bluetooth MIDI controllers and highlights target versus played notes on an on-screen keyboard, with claimed latency under 10ms. - Adaptive metronome and timing analysis: tempo adjusts to accuracy, and the app reports timing deviation (early/late strikes) plus per-run precision scores and consistency sparklines. - Scale library: 48 scales covering major, natural minor, harmonic minor and melodic minor, organized into Novice, Adept and Virtuoso difficulty tiers, with optional finger-number overlays. - Session journal: practice sessions are logged locally (no cloud), with trend analysis, weekly heat maps and CSV export for teachers. - Multilingual interface: English, Spanish, French, German, Japanese, Simplified Chinese and Korean. - Support: a troubleshooting wizard, community FAQ and email ticketing with stated response windows. Stated architecture: a Rust core engine with a lock-free ring buffer for MIDI parsing, an Electron shell with a React 19 frontend and virtualized 88-key keyboard, optional FluidSynth-based internal synthesis for practice without hardware, and SQLite persistence with JSON import/export. The README claims cross-platform binaries for Windows 10/11, macOS 12+ and Linux. Installation is described as a standalone directory: download, extract, run the executable, connect a MIDI device, choose a scale and press Space. No package manager or terminal steps are required. A roadmap mentions pentatonic and blues scales, a fading "Ghost Practice" metronome mode, MIDI output to external synths, and a jazz voice-leading trainer. The project is stated to be MIT licensed, collects no telemetry, and stores logs locally. The README also notes it is a practice aid, not a substitute for professional instruction, and that results depend on MIDI hardware and audio buffer settings.