Full score + parts
Generate a conductor score in concert pitch and transposed student parts from a single source recording.
The problem
Band directors often have recordings, but not classroom-ready parts.
Most audio-to-MIDI tools focus on literal transcription. That can produce rhythms, keys, and phrasing that are technically accurate but too messy for developing student musicians.
What teachers often have
- A recording from rehearsal, a phone memo, or a YouTube link
- A strong musical idea trapped inside a full-band mix
- Limited time to arrange, simplify, and hand out parts
What teachers actually need
- A readable conductor score and student-friendly parts
- Simplified notation that fits middle school ability levels
- A process that feels clear, private, and practical
The solution
ScoreReady bridges the gap between a recording and playable sheet music.
Instead of stopping at raw transcription, ScoreReady adds a musicality layer that makes the output more readable, more teachable, and more useful in a real classroom.
Instrument-aware stems
Separate the track into manageable instrument groups before transcription begins.
Pedagogical simplification
Beginner and Easy Intermediate settings clean rhythms, key choices, and phrasing for students.
Local-first workflow
Everything runs on the user’s machine — no cloud account, no subscription, and more privacy for classroom audio.
How it works
A six-step pipeline from audio input to classroom-ready output.
Each step is designed to be understandable for students presenting the project and practical for educators using it.
Step 1
MP3 / WAV / YouTube URL
Input & extraction
The teacher uploads an audio file or pastes a single YouTube link. ScoreReady extracts and normalizes the audio so the rest of the pipeline starts from a consistent source.
Technical detail: `yt-dlp` handles video extraction and `FFmpeg` normalizes the file for downstream processing.
Step 2
AI isolation
Stem separation
The app peels the track apart into separate audio layers so the important line is easier to hear and interpret.
Technical detail: Meta’s Demucs model splits the music into stem groups like lead, bass, drums, and other.
Step 3
Concert band mapping
Instrument assignment
The teacher connects each stem to the correct concert band instrument using a band-friendly catalog with transposition data.
Technical detail: This assignment layer helps turn generic stems into usable parts for clarinet, trumpet, trombone, and more.
Step 4
The secret sauce
Transcription & musicality layer
Audio becomes MIDI, then the system simplifies difficult rhythms, chooses more readable key signatures, and creates phrase breaks that feel natural for students.
Technical detail: Basic Pitch handles audio-to-MIDI, while `music21` applies custom heuristics for quantization, key choice, and phrase shaping.
Step 5
PDF-ready output
Score assembly & rendering
ScoreReady builds a complete multi-instrument score, applies the right transpositions, and renders clean notation suitable for classroom use.
Technical detail: The pipeline emits MusicXML and renders final PDFs through the MuseScore 4 CLI.
Ready
Classroom handoff
Package & export
The final download includes the conductor score, individual parts, and a settings manifest so each run is easy to revisit, explain, and improve.
Technical detail: A manifest-driven output makes every run traceable and supports quick reruns without repeating expensive stem separation.
Prototype demo
A presentation-friendly mock workflow students can click through.
This lightweight demo simulates how a teacher would move through the product without needing a live backend.
Start here
Upload audio or paste a YouTube link
Teachers can begin with a rehearsal recording, performance clip, or a single YouTube source.
Match separated stems to real band instruments
This keeps the workflow understandable for directors and helps create useful parts instead of generic audio labels.
Stem A — Lead melody
Stem B — Low brass support
Stem C — Rhythmic backbone
Choose the student difficulty level
The musicality layer changes rhythm cleanup, phrase handling, and readability based on the target classroom level.
Your score is ready
Download a complete classroom package
Everything is bundled together so the teacher can print, rehearse, revise, and rerun with confidence.
Conductor Score (Concert Pitch)PDF
Individual Student PartsPDF Set
Run Settings & Traceabilitymanifest.json
Key features
Built to be powerful under the hood, but calm and practical on the surface.
Audio-to-score pipeline
Move from source audio to a printable score in one guided workflow.
AI stem separation
Isolate important material so transcription has a cleaner signal to work from.
Musicality layer
Simplify rhythms and notation for middle school performance readiness.
Quick rerun
Adjust difficulty without having to repeat the slowest parts of the pipeline.
Run history + manifest
Every output stays traceable, making it easier to explain, compare, and refine.
Local-first privacy
Classroom recordings stay on the teacher’s machine instead of heading to the cloud.
Technology behind it
The pipeline combines specialized music and audio tools.
Each layer handles a specific job, which makes the system easier to reason about, test, and improve.
Frontend — Streamlit
An approachable Python-based UI for educators and quick experimentation.
Extraction — yt-dlp + FFmpeg
Bring in and normalize audio from local files or a single video source.
Stem Separation — Demucs
Split the recording into clearer instrument groups before transcription.
Transcription — Basic Pitch
Convert isolated audio into MIDI note data.
Symbolic Logic — music21
Quantize, simplify, choose readable keys, and shape phrasing for students.
Rendering — MuseScore 4 CLI
Produce polished printable PDFs from MusicXML.
Why it matters
ScoreReady is designed around real classroom usefulness.
The project matters not because it uses AI, but because it helps educators get from sound to usable teaching material faster and more clearly.
1 run
From recording to packet
A single workflow produces a score, parts, and a manifest.
100%
Local-first privacy
Classroom audio stays on-device, which is useful for trust and control.
2+
Student difficulty levels
Teachers can rerun the same source at a more playable level.
6 steps
Clear presentation story
The workflow is easy for students to explain during a demo.
“This helps a director move from inspiration to rehearsal material.”
“The point isn’t literal transcription. The point is usable music.”
“Ready means a student can actually put it on the stand and play it.”
Challenges & next steps
There is still room to improve accuracy, speed, and classroom polish.
Current challenges
- Similar instruments can be difficult to separate cleanly in a dense mix.
- Transcription quality depends on recording clarity and balance.
- Simplification rules may need tuning for different ensembles.
Future improvements
- Smarter instrument recognition during stem assignment.
- Side-by-side rerun comparison for easier preset tuning.
- Better confidence scores and more flexible difficulty presets.
Conclusion
ScoreReady helps transform recordings into classroom-ready music.
It combines AI audio tools with practical music education goals so that teachers get something they can actually hand to students: clear, simplified, playable scores.