# sergree/matchering

🎚️ Open Source Audio Matching and Mastering

Repository: https://github.com/sergree/matchering
Canonical: https://ross.abutalabs.com/products/matchering
Homepage: https://pypi.org/project/matchering/
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: audio, sound, mastering, matchering, dsp, equalizer, music, vst, matching, spectrum, numpy, scipy, python, python3, limiter, filter, python-library, docker-image
Last push: 2026-07-08T14:37:52+00:00

## Health v2 (maintenance only)
Score: 64/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 8, longevity 100
- inputs: {"age_days": 2896, "days_push": 56, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2615, forks 289 (observed 2026-08-28T04:07:04.599224+00:00)

## What it is
Matchering 2.0 is an open-source Python library, containerized web app, and ComfyUI node for audio matching and mastering. It takes a target track and a reference track, then produces a mastered version of the target matching the reference's RMS, frequency response, peak amplitude, and stereo width.

## Use cases
- master my track to sound like a reference song
- automated audio mastering in python
- match loudness and EQ of two songs
- make all album tracks sound consistent
- batch mastering with docker
- free alternative to AI mastering services

## When to choose
- you want automated reference-based mastering without manual EQ/limiting
- you need a scriptable Python or Docker mastering pipeline
- you want a free open-source alternative to online mastering services

## When to avoid
- you need full manual control over mastering chain like a DAW
- you need real-time processing
- you require a commercial-friendly license (GPL-3.0)

## Facets
- artifact type: library
- maturity: active
- function: audio-processing, machine-learning
- domain: audio, media
- platform: python, cross-platform
- tags: mastering, dsp, audio-matching, vst, equalizer, limiter, comfyui, audio, docker

## Member repositories
- sergree/matchering (main) score 64

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:04.599224+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:20:33.796812+00:00, confidence not recorded.
  - readme: https://github.com/sergree/matchering (fetched 2026-08-28T04:07:04.599224+00:00, sha b6638a9ed9b2)
  - homepage: https://pypi.org/project/matchering/ (fetched 2026-08-29T10:03:30.363172+00:00, sha 4b4e8fead74a)
  - registry_pypi: https://pypi.org/pypi/matchering/json (fetched 2026-08-29T10:03:30.365645+00:00, sha 2739a655caf9)
- Data as of 2026-08-30T08:39:29.467469+00:00.