How sergree/matchering works
Matchering is an audio-matching and mastering Python library. A caller supplies target and reference audio, invokes the public processing API, and receives mastered audio saved in requested formats; optional results include un-limited audio and previews. The documented Docker, desktop, and ComfyUI uses are integrations around this library, not runtime components in this repository. The graph follows the indexed imports and explicit README workflow; unsampled modules are included where their subsystem is clear, but no uncertain internal calls are inferred.
Main entry points: core.py Processing coordinator · __init__.py Public API · checker.py Input validation · stages.py Mastering stages
Components 18
Library API
- Public API
matchering/__init__.py - Processing config
matchering/defaults.py
Audio Processing
- Input validation
matchering/checker.py - Audio loading
matchering/loader.py - Processing coordinator
matchering/core.py - Level matching
matchering/stage_helpers/match_levels.py - Frequency matching
matchering/stage_helpers/match_frequencies.py - Mastering stages
matchering/stages.py - Hyrax limiter
matchering/limiter/hyrax.py
Results and Outputs
- Result formats
matchering/results.py - Audio export
matchering/saver.py - Preview creation
matchering/preview_creator.py
Shared Internals
- Audio DSP primitives
matchering/dsp.py - Logging and errors
matchering/log - Audio utilities
matchering/utils.py
Other components
- Library caller
- Target and reference
- Output audio files
Connections 32
- Library caller → Public API: calls
README.md - Target and reference → Public API: provides audio
README.md - Public API → Processing coordinator: exposes
matchering/__init__.py - Public API → Processing config: exposes
matchering/__init__.py - Public API → Result formats: exposes
matchering/__init__.py - Public API → Audio loading: exposes
matchering/__init__.py - Public API → Input validation: exposes
matchering/__init__.py - Public API → Logging and errors: exposes logging
matchering/__init__.py - Processing coordinator → Audio loading: loads
matchering/core.py - Processing coordinator → Input validation: validates
matchering/core.py - Processing coordinator → Mastering stages: processes audio
matchering/core.py - Processing coordinator → Audio export: saves results
matchering/core.py - Processing coordinator → Preview creation: creates previews
matchering/core.py - Processing coordinator → Processing config: uses config
matchering/core.py - Processing coordinator → Result formats: uses result specs
matchering/core.py - Audio loading → Input validation: checks audio
matchering/core.py - Mastering stages → Level matching: uses
matchering/stages.py - Mastering stages → Frequency matching: uses
matchering/stages.py - Mastering stages → Hyrax limiter: limits output
matchering/stages.py - Level matching → Audio DSP primitives: uses
matchering/stage_helpers/match_levels.py - Frequency matching → Audio DSP primitives: uses
matchering/stage_helpers/match_frequencies.py - Hyrax limiter → Audio DSP primitives: uses
matchering/limiter/hyrax.py - Input validation → Audio DSP primitives: uses
matchering/checker.py - Input validation → Audio utilities: uses
matchering/checker.py - Preview creation → Audio export: writes previews
matchering/preview_creator.py - Preview creation → Audio DSP primitives: selects and fades
matchering/preview_creator.py - Audio export → Output audio files: writes audio
README.md - Preview creation → Output audio files: writes previews
matchering/preview_creator.py - Mastering stages → Logging and errors: logs stages
matchering/stages.py - Processing coordinator → Logging and errors: logs processing
matchering/core.py - Audio loading → Logging and errors: reports load errors
matchering/loader.py - Input validation → Logging and errors: reports checks
matchering/checker.py