{"id":13396950,"url":"https://github.com/sergree/matchering","last_synced_at":"2026-10-19T07:59:44.153Z","repository":{"id":37949735,"uuid":"150785299","full_name":"sergree/matchering","owner":"sergree","description":"🎚️ Open Source Audio Matching and Mastering","archived":false,"fork":false,"pushed_at":"2026-10-07T14:04:36.000Z","size":6327,"stargazers_count":2658,"open_issues_count":34,"forks_count":298,"subscribers_count":48,"default_branch":"master","last_synced_at":"2026-10-15T00:37:15.762Z","etag":null,"topics":["audio","docker-image","dsp","equalizer","filter","limiter","mastering","matchering","matching","music","numpy","python","python-library","python3","scipy","sound","spectrum","vst"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/matchering/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sergree.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"SUPPORTERS.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":"https://t.me/tribute/app?startapp=de85"}},"created_at":"2018-09-28T19:21:01.000Z","updated_at":"2026-10-14T05:13:08.000Z","dependencies_parsed_at":"2023-02-08T09:17:09.260Z","dependency_job_id":"70450d81-91bd-437a-9694-2d5b90e6e861","html_url":"https://github.com/sergree/matchering","commit_stats":{"total_commits":359,"total_committers":7,"mean_commits":"51.285714285714285","dds":0.3231197771587744,"last_synced_commit":"817d041ee245e4087d24b80d865558ae858d016b"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/sergree/matchering","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergree%2Fmatchering","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergree%2Fmatchering/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergree%2Fmatchering/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergree%2Fmatchering/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sergree","download_url":"https://codeload.github.com/sergree/matchering/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergree%2Fmatchering/sbom","scorecard":{"id":675484,"data":{"date":"2025-08-11","repo":{"name":"github.com/sergree/matchering","commit":"6aca25d18b7430a2b44ae71f23504250f9d33d36"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":4,"reason":"5 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 4","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/pythonpublish.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pythonpublish.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/sergree/matchering/pythonpublish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pythonpublish.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/sergree/matchering/pythonpublish.yml/master?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/pythonpublish.yml:18","Warn: pipCommand not pinned by hash: .github/workflows/pythonpublish.yml:19","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":9,"reason":"1 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2023-102"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-21T21:18:25.429Z","repository_id":37949735,"created_at":"2025-08-21T21:18:25.430Z","updated_at":"2025-08-21T21:18:25.430Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38351721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-19T02:00:06.414Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","docker-image","dsp","equalizer","filter","limiter","mastering","matchering","matching","music","numpy","python","python-library","python3","scipy","sound","spectrum","vst"],"created_at":"2024-07-30T18:01:08.306Z","updated_at":"2026-10-19T07:59:44.148Z","avatar_url":"https://github.com/sergree.png","language":"Python","funding_links":["https://t.me/tribute/app?startapp=de85"],"categories":["Audio","资源列表","Tools for Self-Hosting","Python","音频","Audio Tools","Audio Related Packages","Software","HarmonyOS","Multimedia","Audio [🔝](#readme)","DSP, Transforms \u0026 Spectral Analysis","Audio Processing \u0026 I/O"],"sub_categories":["音频","Automation","Windows Manager","Media Servers","Drone Frames","IO router / deconstructed loops anchor"],"readme":"[![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://t.me/tribute/app?startapp=de85)\n\n![Matchering 2.0](https://raw.githubusercontent.com/sergree/matchering/master/images/logo.png)\n\n[![License](https://img.shields.io/pypi/l/matchering.svg)](https://pypi.python.org/pypi/matchering/)\n[![PyPI Version](https://badge.fury.io/py/matchering.svg)](https://badge.fury.io/py/matchering)\n[![PyPI Python Versions](https://img.shields.io/pypi/pyversions/matchering.svg)](https://pypi.python.org/pypi/matchering/)\n[![Mentioned in Awesome Python](https://awesome.re/mentioned-badge.svg)](https://github.com/vinta/awesome-python)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n## Matching + Mastering = ❤️\n\n**[Matchering 2.0]** is a novel **[Containerized Web Application](#docker-image)**, **[Python Library][PyPI]**, and **[ComfyUI Node](#comfyui-node)** for audio matching and [mastering].\n\n🔥 Also integrated in the **[UVR5 Desktop App](https://ultimatevocalremover.com/)**!\n\nIt follows a *simple idea* - you take TWO audio files and feed them into **Matchering**: \n- **TARGET** (the track you want to master, you want it to sound like the reference)\n- **REFERENCE** (another track, like some kind of \"wet\" popular song, you want your target to sound like it)\n\nOur algorithm matches both of these tracks and provides you the mastered **TARGET** track with the same [RMS], [FR], [peak amplitude] and [stereo width] as the **REFERENCE** track has.\n\n🔥 **[Benn Jordan Matchering review][BennVideo]**:\n\u003e - ***Matchering 2.0 beating all other AI's**! (note: by carefully selecting a proper song as reference)*\n\u003e - *Ranking it no.3 (out of 12) right behind 2 professional master engineers*\n\u003e - *Seems a rock-solid study with 472 judged entries*\n\u003e \n\u003e *(Thanks to [@bascurtiz](https://github.com/bascurtiz) for [the find](https://github.com/sergree/matchering/issues/59))*\n\n[![Benn Jordan Review Video](http://i3.ytimg.com/vi/wZRV2H4PK0Q/hqdefault.jpg)][BennVideo]\n\nYou can try out **Matchering** yourself without having to install it, thanks to the hosting provided by **[Songmastr](https://www.songmastr.com/)**, **[MVSEP](https://mvsep.com/)** and **[Moises](https://moises.ai/)**.\n\nWatch **[the video][Video]**:\n\n[![Matchering 2.0 Promo Video](http://img.youtube.com/vi/8Su5STDYfcA/0.jpg)][Video]\n\nSo **Matchering 2.0** will make your song sound the way you want! It opens up a wide range of opportunities:\n- You can make your music instantly sound like your favorite artist's music\n- You can make all the tracks on your new album sound the same very quickly\n- You can find new aspects of your sound in experiments\n- You can do everything as you want! Because of **[Your References, Your Rules.™](https://macprovideo.com/article/audio-software/sound-tools-instant-online-mastering-with-reference-matching-now-in-open-beta)** *(just a little nostalgic note)* 🤭\n\n![Matchering WEB GIF Animation](https://raw.githubusercontent.com/sergree/matchering/master/images/animation.gif \"Matchering WEB\")\n\n\u003e Differences from the previous major version:\n\u003e - Completely rewritten in [Python 3], based on open source tech stack (no more [MATLAB])\n\u003e - Our own open source [Hyrax] [brickwall limiter] was implemented for it\n\u003e - Processing speed and accuracy have been increased\n\u003e - Now it is [the library][PyPI] that can be connected to **everything** in **the Python world**\n\nIf you are looking for a **Matchering paper**, you can read **[this Habr article](https://habr.com/ru/post/709120/)**.\n\n# Installation and Usage\n\nIf you are a music producer or an audio engineer, choose the **[Desktop App](#desktop-app---the-easiest-way)** or **[ComfyUI Node](#comfyui-node)**. \n\nIf you are an AI mastering startup, choose the **[Docker Image](#docker-image)**. \n\nIf you are a developer, choose the **[Python Library](#python-library---for-developers)**.\n\n# Desktop App - The Easiest Way\n\n### [NEW! Matchering @ UVR5 Desktop App](https://ultimatevocalremover.com/)\nYou can find Matchering under `Choose Process Method \u003e Audio Tools \u0026 Choose Audio Tool \u003e Matchering`.\n\n### [Or try WITHOUT Installation](https://www.youtube.com/watch?v=Aw0nH6QqAck)\n\n# ComfyUI Node\n\n### [ComfyUI-Matchering](https://github.com/MuziekMagie/ComfyUI-Matchering)\n\n# Docker Image\n\n### [Windows](https://github.com/sergree/matchering/blob/master/DOCKER_WINDOWS.md)\n### [macOS](https://github.com/sergree/matchering/blob/master/DOCKER_MACOS.md)\n### [Linux](https://github.com/sergree/matchering/blob/master/DOCKER_LINUX.md)\n\n## Updating\n\nIf you need to update the version of the installed **Docker Image**, follow **[these instructions](https://github.com/sergree/matchering/blob/master/DOCKER_UPDATING.md)**.\n\n# Python Library - For Developers\n\n## Installation\n\n**4 GB RAM machine with [Python 3.8.0 or higher][Python 3] is required**\n\n### libsndfile\n\n**Matchering 2.0** depends on the **[SoundFile]** library, which depends on the system library **[libsndfile]**. On Windows and macOS, it installs automatically. On Linux, you need to install **[libsndfile]** using your distribution's package manager, for example:\n\n```sudo apt update \u0026\u0026 sudo apt -y install libsndfile1```\n\n### python3-pip\n\nOn some Linux distributions, **python3-pip** is not installed by default. For example use this command on Ubuntu Linux to fix this:\n\n```sudo apt -y install python3-pip```\n\n### Matchering Python Package\n\nFinally, install our `matchering` package:\n\n```\n# Linux / macOS\npython3 -m pip install -U matchering\n\n# Windows\npython -m pip install -U matchering\n```\n\n### *(Optional) FFmpeg*\n\nIf you would like to enable *MP3 loading support*, you need to install the **[FFmpeg][FFmpeg]** library. For example use this command on Ubuntu Linux:\n\n```sudo apt -y install ffmpeg```\n\nOr follow these instructions: [Windows][FFmpeg-win], [macOS][FFmpeg-mac].\n\n## Quick Example\n\n```python\nimport matchering as mg\n\n# Sending all log messages to the default print function\n# Just delete the following line to work silently\nmg.log(print)\n\nmg.process(\n    # The track you want to master\n    target=\"my_song.wav\",\n    # Some \"wet\" reference track\n    reference=\"some_popular_song.wav\",\n    # Where and how to save your results\n    results=[\n        mg.pcm16(\"my_song_master_16bit.wav\"),\n        mg.pcm24(\"my_song_master_24bit.wav\"),\n    ],\n)\n\n```\n\nYou can find more examples in the **[examples directory]**.\n\n### Or you can use premade **Matchering 2.0 Command Line Application**: **[matchering-cli]**.\n### Or its enhanced fork: **[kubinka0505/matchering-cli]**.\n\n## 💓 WhatBPM\n\nLooking for the perfect BPM or key for a new EDM track?\n\n**[Check out WhatBPM!](https://sergree.github.io/whatbpm)**\n\nA completely free open-source web service from the author of Matchering.\n\n## A Coffee\n\nIf our package saved your time or money, you may:\n\n[![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://t.me/tribute/app?startapp=de85)\n\n**Thank you!**\n\n## Links\n\n- [Press About Us](https://github.com/sergree/matchering/blob/master/PRESS.md)\n- [Supporters](https://github.com/sergree/matchering/blob/master/SUPPORTERS.md)\n- [Our Limiter Quality Test](https://github.com/sergree/matchering/blob/master/LIMITER_TEST.md)\n- [Matchering Hyrax Limiter JSFX clone by Tokyo Dawn Labs](https://github.com/JClones/JSFXClones/blob/master/JClones_Hyrax.md)\n- [Log Codes Overview](https://github.com/sergree/matchering/blob/master/LOG_CODES.md)\n- [Our Thoughts](https://github.com/sergree/matchering/blob/master/THOUGHTS.md)\n\n[Matchering]: https://github.com/sergree/matchering\n[Matchering 2.0]: https://github.com/sergree/matchering\n[Hyrax]: https://github.com/sergree/matchering/tree/master/matchering/limiter\n[mastering]: https://en.wikipedia.org/wiki/Audio_mastering\n[RMS]: https://en.wikipedia.org/wiki/Root_mean_square\n[FR]: https://en.wikipedia.org/wiki/Frequency_response\n[peak amplitude]: https://en.wikipedia.org/wiki/Amplitude\n[stereo width]: https://en.wikipedia.org/wiki/Stereo_imaging\n[MATLAB]: https://www.mathworks.com/products/matlab.html\n[Python 3]: https://www.python.org/\n[brickwall limiter]: https://en.wikipedia.org/wiki/Dynamic_range_compression#Limiting\n[PyPI]: https://pypi.org/project/matchering\n[SoundFile]: https://github.com/bastibe/SoundFile#installation\n[libsndfile]: http://www.mega-nerd.com/libsndfile/\n[FFmpeg]: https://www.ffmpeg.org/download.html\n[FFmpeg-win]: https://video.stackexchange.com/questions/20495/how-do-i-set-up-and-use-ffmpeg-in-windows\n[FFmpeg-mac]: https://superuser.com/questions/624561/install-ffmpeg-on-os-x\n[matchering-cli]: https://github.com/sergree/matchering-cli\n[kubinka0505/matchering-cli]: https://github.com/kubinka0505/matchering-cli\n[examples directory]: https://github.com/sergree/matchering/tree/master/examples\n[Video]: http://www.youtube.com/watch?v=8Su5STDYfcA \"Matchering 2.0 - Open Source Audio Matching and Mastering\"\n[BennVideo]: https://www.youtube.com/watch?v=wZRV2H4PK0Q \"Benn Jordan Matchering 2.0 Review\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergree%2Fmatchering","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsergree%2Fmatchering","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergree%2Fmatchering/lists"}