Audio Matching and Mastering Python Library
Project description
Matching + Mastering = ❤️
Matchering 2.0 is a novel Containerized Web Application and Python Library for audio matching and mastering.
It follows a simple idea - you take TWO audio files and feed them into Matchering:
- TARGET (the track you want to master, you want it to sound like the reference)
- REFERENCE (another track, like some kind of "wet" popular song, you want your target to sound like it)
Our 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.
You can try out Matchering yourself without having to install it, thanks to the hosting provided by Moises.ai.
Watch the video:
So Matchering 2.0 will make your song sound the way you want! It opens up a wide range of opportunities:
- You can make your music instantly sound like your favorite artist's music
- You can make all the tracks on your new album sound the same very quickly
- You can find new aspects of your sound in experiments
- You can do everything as you want! Because of Your References, Your Rules.™ (just a little nostalgic note) 🤭
Differences from the previous major version:
- Completely rewritten in Python 3, based on open source tech stack (no more MATLAB)
- Our own open source brickwall limiter was implemented for it
- Processing speed and accuracy have been increased
- Now it is the library that can be connected to everything in the Python world
Installation and Usage
If you are a music producer or an audio engineer, choose the Docker Image.
If you are a developer, choose the Python Library.
Docker Image - The Easiest Way
Matchering 2.0 works on all major platforms using Docker.
Choose yours
Windows
macOS
Linux
Updating
If you need to update the version of the installed Docker Image, follow these instructions.
Python Library - For Developers
Installation
4 GB RAM machine with Python 3.8.0 or higher is required
libsndfile
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:
sudo apt update && sudo apt -y install libsndfile1
python3-pip
On some Linux distributions, python3-pip is not installed by default. For example use this command on Ubuntu Linux to fix this:
sudo apt -y install python3-pip
Matchering Python Package
Finally, install our matchering
package:
# Linux / macOS
python3 -m pip install -U matchering
# Windows
python -m pip install -U matchering
(Optional) FFmpeg
If you would like to enable MP3 loading support, you need to install the FFmpeg library. For example use this command on Ubuntu Linux:
sudo apt -y install ffmpeg
Or follow these instructions: Windows, macOS.
Quick Example
import matchering as mg
# Sending all log messages to the default print function
# Just delete the following line to work silently
mg.log(print)
mg.process(
# The track you want to master
target="my_song.wav",
# Some "wet" reference track
reference="some_popular_song.wav",
# Where and how to save your results
results=[
mg.pcm16("my_song_master_16bit.wav"),
mg.pcm24("my_song_master_24bit.wav"),
],
)
You can find more examples in the examples directory.
Or you can use premade Matchering 2.0 Command Line Application: matchering-cli.
A Coffee
If our package saved your time or money, you may:
Thank you!
Links
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file matchering-2.0.6.tar.gz
.
File metadata
- Download URL: matchering-2.0.6.tar.gz
- Upload date:
- Size: 31.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.10.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 683f5ff76b1a2f1e852c79108cfccfdab4baf901357a97d38555b4da5d5c5a25 |
|
MD5 | 4bc99a429f90bf86cd291cc53182df87 |
|
BLAKE2b-256 | 13a28dd0e1f3da3a6f4d50d1f06f91117370844edb9e8cce1ff798a7cdc0cece |
File details
Details for the file matchering-2.0.6-py3-none-any.whl
.
File metadata
- Download URL: matchering-2.0.6-py3-none-any.whl
- Upload date:
- Size: 41.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.10.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | eb9bce4e123e9d515d5365fdd93df465398f69e0a530d51f3a57d976b757b032 |
|
MD5 | 565c23cbef2e29dd3a40590165e7f4da |
|
BLAKE2b-256 | 34a2e46fd6c3839f4774e1b225a5d9dfb87634010b01bf7dea34ce1c1e364f7a |