Description 📝

Pack of scripts providing customizable audio matchering.

Features comparison:

	sergree's matchering	sergree's matchering-cli	kubinka0505's matchering-cli
Cross-platform	✅	❌	✅
URL support	❌	❌	✅
Sample rate heritage	✅⚙️	❌	✅
FFT setting	✅⚙️	❌	✅
Normalization disable	✅⚙️	✅	✅
Limiting disable	✅⚙️	✅	✅

_{⚙️ - intermediate module knowledge required}

Requirements 📥

Programs:

• Python >= 3.8 🐍

Modules:

• matchering >= 2.0.6 - Audio matchering module 🔎
• mutagen >= 1.45.1 - Audio info checker 🔊
• requests >= 2.12.5 - URL fetching 🔗
• distro >= 1.7* - Unix directory opening handler 📂

Packages (bold links are Windows static executable binaries):

• FFmpeg >= 4.2 - Audio processing 🎦
  • 64-bit reccomended! (possible memory allocation failures)
• Python3-PIP*

* - Required on Linux

Installation ⚙️

When on Linux, install required packages by using this one-liner:

sudo apt-get install git python3-apt python3-pip ffmpeg

1. Clone the repository and move to its directory.

   git clone https://github.com/kubinka0505/matchering-cli
   cd matchering-cli
   

2. Install required modules by inputting pip install -r requirements.txt
3. Type mg_cli.py -h for more info. ℹ️

---

Usage 📝

Process target input file (-i) and reference audio (-r)

mg_cli.py -i "~/Desktop/Song.wav" -r "~/Downloads/Better_Song.flac"

As above, but set target directory (-o) and bit depth to 16

mg_cli.py -i "../Sound.flac" -r "%UserProfile%\Downloads\Music.ogg" -o "~/Music/My Songs" -b 16

Process with custom FFT window size (-fft) and inherit sample rate (-sr auto)

mg_cli.py -i "https://website.com/Audio.ogg" -r "~/Music/Discography/Artist/Album/Artist - Title.flac" -fft 2048 -sr auto

As above, but do not apply limiting (-nl, and normalization (-nn) and process with full logs (-v 2)

mg_cli.py -i "https://website.com/Artist ft. Guest - Title (Remix).flac" -r "File.wav" -fft 4096 -sr auto -nl -nn -v 2

---

Meta Info ℹ️

All versions of this project have been tested on:

OS	Distribution	OS Version	Python Version	System Architecture (bits)
Windows	―	10	3.11.0	64
Linux	Ubuntu	LTS 22.04	3.10.6	64