whatisgithub

What is oboe-reed-debugger?

yuefu-jiang/oboe-reed-debugger — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · general

In one sentence

A browser only tool that records an oboe reed's crow sound and diagnoses what is wrong with it by analyzing pitch and overtones.

Mindmap

mindmap
  root((Oboe Reed Debugger))
    What it does
      Records reed crow
      Diagnoses reed problems
      Runs fully in browser
    Tech stack
      TypeScript
      Svelte
      Web Audio API
    Use cases
      Check reed health
      Practice with metronome
      Browse symptom guide
    Audience
      Oboe players
      Reed makers
      Curious hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Record a reed's crow and get a breakdown of its octaves, overtones, and pitch stability.

USE CASE 2

Look up likely causes and fixes for reed problems by region of the reed.

USE CASE 3

Practice steady playing with the built in metronome.

USE CASE 4

Watch a live tuner and spectrogram while playing to monitor pitch in real time.

What is it built with?

TypeScriptSvelteWeb Audio APICanvas 2D

How does it compare?

yuefu-jiang/oboe-reed-debugger0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhard
Complexity4/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

So what is it?

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.

Copy-paste prompts

Prompt 1
Explain how autocorrelation pitch detection works in simple terms using this reed debugger as an example.
Prompt 2
Walk me through how the Goertzel algorithm is used here instead of a full FFT.
Prompt 3
Help me understand what a reed's crow tells a player about reed quality.
Prompt 4
Suggest how I could add a new symptom entry to this app's diagnostic database.

Frequently asked questions

What is oboe-reed-debugger?

A browser only tool that records an oboe reed's crow sound and diagnoses what is wrong with it by analyzing pitch and overtones.

What language is oboe-reed-debugger written in?

Mainly TypeScript. The stack also includes TypeScript, Svelte, Web Audio API.

Who is oboe-reed-debugger for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.