2025-12-21 12:58:40 +01:00
2025-12-30 19:41:21 +01:00
2025-12-21 12:20:30 +01:00
2025-12-21 12:20:40 +01:00
2025-12-28 15:31:32 +01:00
2025-12-21 12:20:40 +01:00
2025-12-21 12:20:40 +01:00
2025-12-27 22:46:58 +01:00
2025-12-21 12:20:40 +01:00
2025-12-21 12:20:40 +01:00
2025-12-21 12:20:40 +01:00

Sheet Music Trainer

A web-based application designed to help musicians practice sight-reading and ear training. It listens to your instrument (or voice) via the microphone and gives real-time feedback.

Live Demo (If available)

Features

  • Sight Reading Mode: Read notes from the interactive staff and play them on your instrument. The app listens and confirms when you hit the correct note.
  • Ear Training Mode: Listen to a reference note and try to reproduce it.
  • Real-time Pitch Detection: Uses your device's microphone to detect notes instantly.
  • Instrument Support: Optimized for Guitar and Piano, with configurable tunings for guitar.
  • Virtual Instruments: On-screen interactive guitar fretboard and piano keys for visual reference or touch input.
  • Customizable: Adjust difficulty (range, accidentals), key signatures, rhythm/metronome settings, and more.
  • Zen Mode: Distraction-free practice interface.

Getting Started

Prerequisites

  • Node.js (v18 or higher recommended)
  • npm

Installation

  1. Clone the repository:

    git clone https://github.com/9x/sheetmusictrainer.git
    cd sheetmusictrainer
    
  2. Install dependencies:

    npm install
    
  3. Run the development server:

    npm run dev
    
  4. Open your browser and navigate to the local URL provided (usually http://localhost:5173).

Technical Details

100% vibe coded using Google Antigravity and Gemini 3 pro.

This project is built with:

  • React + TypeScript
  • Vite
  • VexFlow (for music notation)
  • Pitchfinder (for audio detection)

For more details on the architecture, see TECHNICAL_REALIZATION.md.

License

MIT

Description
No description provided
Readme 299 KiB
Languages
TypeScript 84%
CSS 15.4%
JavaScript 0.3%
HTML 0.3%