yuefu-jiang/oboe-reed-debugger — explained in plain English
Analysis updated 2026-05-18
Record a reed's crow and get a breakdown of its octaves, overtones, and pitch stability.
Look up likely causes and fixes for reed problems by region of the reed.
Practice steady playing with the built in metronome.
Watch a live tuner and spectrogram while playing to monitor pitch in real time.
| yuefu-jiang/oboe-reed-debugger | 0xkinno/astraea | 0xkinno/halcyon | |
|---|---|---|---|
| Stars | 0 | 0 | 0 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | — | hard | hard |
| Complexity | — | 4/5 | 4/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Oboe Reed Debugger is a web app built for oboe players who want to figure out what is wrong with their reed. It works by listening to the reed's crow, which is the raw buzzing sound a reed makes when blown alone without the rest of the instrument. Every part of this happens right in your browser. No recording is ever sent to a server, so nothing about your reed leaves your device. The app has four screens that share the same audio setup. The Tuner shows your pitch in real time along with a scrolling graph of frequencies, similar to what a musician might see on a professional pitch device. The Reed Analysis screen is the core feature: you record a crow, and the app breaks down which musical octaves and extra overtones are present, checks how stable the pitch is, and compares the pattern against a built in list of common reed problems, then points to likely causes by region of the reed, such as the tip, heart, or back. The Metronome is a simple adjustable click track for practicing steady playing. The Guide is a browsable reference of reed symptoms and fixes. Under the hood, the app uses standard browser audio tools to capture sound and figure out pitch through a method called autocorrelation, which looks for repeating patterns in the sound wave. For the deeper reed analysis, it uses a technique called the Goertzel algorithm to check specific frequencies efficiently, then works out the reed's true fundamental tone even when that tone is quiet or hard to hear underneath louder overtones. From that fundamental, it builds out the full expected pattern of octaves and overtones a healthy reed crow should produce, and compares the actual recording against that pattern. There is no backend server, no database, and no login. It is a self contained static website. This project would suit oboe players and reed makers who want a quick, private way to check reed health without special hardware, and anyone curious about applying signal processing to acoustic instrument diagnostics.
A browser only tool that records an oboe reed's crow sound and diagnoses what is wrong with it by analyzing pitch and overtones.
Mainly TypeScript. The stack also includes TypeScript, Svelte, Web Audio API.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.