How elevatormusic/ears-bridge works
EARS Bridge is a desktop headphone-measurement bridge: the user selects EARS input, virtual-cable output, and left/right calibration files, then starts a Dirac sweep. The audio engine captures both channels, applies per-ear correction, routes the swept ear, and uses asynchronous resampling to deliver a single-microphone signal to Dirac. Separate branches support device/format checks, measurement-health feedback, reference-based grading, and diagnostics. The README documents the principal audio flow; some internal subsystem links are omitted where the excerpts and index do not establish who invokes whom.
Main entry points: AudioEngine.cpp Audio engine · MainComponent.cpp Desktop interface · DeviceManager.cpp Device selection · CalFile.cpp Calibration files
Components 20
Application
- Desktop interface
src/gui/MainComponent.cpp - Device selection
src/audio/DeviceManager.cpp - Endpoint formats
src/platform/EndpointFormat.cpp
Audio runtime
- Audio engine
src/audio/AudioEngine.cpp - Per-ear routing
src/audio/ScheduledEarRouter.h - Clock conversion
src/audio/ClockBridge.h - Signal processing
src/audio/ProcessingGraph.cpp
Calibration
- Calibration files
src/cal/CalFile.cpp - Pair validation
src/cal/CalibrationPairValidator.cpp - Correction FIRs
src/cal/FirDesigner.cpp
Measurement quality
- Capture safeguards
src/audio/HealthMonitor.cpp - Sweep reference
src/audio/LoopbackReference.cpp - Reference grading
src/audio/ReferenceGradePoller.cpp - Sweep deconvolution
src/audio/Deconvolver.cpp
State and diagnostics
- User settings
src/state/Settings.cpp - Diagnostic log
src/diag/DiagnosticLog.cpp
Other components
- Operator
- EARS microphones
- Dirac Live
- Virtual cable
Connections 20
- Operator → Desktop interface: configures and starts
README.md - EARS microphones → Audio engine: provides two channels
README.md - Desktop interface → Device selection: selects devices
- Device selection → Endpoint formats: checks endpoint formats
src/audio/DeviceManager.cpp - Desktop interface → User settings: persists configuration
- Desktop interface → Calibration files: loads calibration files
- Desktop interface → Pair validation: validates calibration pair
src/gui/MainComponent.cpp - Calibration files → Pair validation: checks sides
- Desktop interface → Correction FIRs: requests FIR rebuild
- Audio engine → Correction FIRs: applies ear corrections
README.md - Audio engine → Per-ear routing: selects swept ear
README.md - Audio engine → Clock conversion: resamples across clocks
README.md - Audio engine → Signal processing: processes audio
- Audio engine → Capture safeguards: detects capture faults
README.md - Audio engine → Sweep reference: captures Dirac sweep
README.md - Sweep reference → Reference grading: supplies reference
- Reference grading → Sweep deconvolution: deconvolves capture
- Desktop interface → Diagnostic log: records diagnostics
- Audio engine → Virtual cable: sends corrected signal
README.md - Virtual cable → Dirac Live: provides virtual microphone
README.md