Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sergree/matchering-cli
🎚️ Simple Matchering 2.0 Command Line Application
https://github.com/sergree/matchering-cli
audio cli dsp equalizer filter limiter mastering matchering matching music python python3 sound spectrum vst
Last synced: about 2 months ago
JSON representation
🎚️ Simple Matchering 2.0 Command Line Application
- Host: GitHub
- URL: https://github.com/sergree/matchering-cli
- Owner: sergree
- License: gpl-3.0
- Created: 2020-01-11T20:47:30.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-03-06T07:00:28.000Z (over 1 year ago)
- Last Synced: 2024-04-20T09:07:12.038Z (5 months ago)
- Topics: audio, cli, dsp, equalizer, filter, limiter, mastering, matchering, matching, music, python, python3, sound, spectrum, vst
- Language: Python
- Homepage:
- Size: 48.8 KB
- Stars: 58
- Watchers: 4
- Forks: 14
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-python-audio - Matchering-cli
README
[](https://pip.me/sergree)
# Matchering CLI
### Simple Matchering 2.0 Command Line Application
Compact and easy-to-use CLI app for working with the **[Matchering python library][matchering]**. Use it for audio batch processing.
## Features
- File logging
- 16-bit, 24-bit, and 32-bit float results
- Setting to disable the built-in *Matchering limiter* and *normalization*
## Installation
### Ubuntu 20.04 LTS
1. Install the necessary dependencies
```sudo apt update && sudo apt -y install libsndfile1 ffmpeg python3-pip```
2. Clone the repo and move to the directory
```git clone https://github.com/sergree/matchering-cli && cd matchering-cli```
3. Install dependencies from `requirements.txt`
```python3 -m pip install -r requirements.txt```
### Windows 10
1. Install **[Anaconda Python/R Distribution][anaconda]**
2. Install **[FFmpeg]** to `C:\ffmpeg` and add `C:\ffmpeg\bin` to the PATH variable
**[HOWTO][path]**
3. Run **Anaconda Prompt (Anaconda3)** and move to the cloned `matchering-cli` directory
```cd C:\Users\\Downloads\matchering-cli```
4. Install dependencies from `requirements.txt`
```python -m pip install -r requirements.txt```
## Usage
- Get the WAV 16-bit result
```python3 mg_cli.py my_song.wav some_popular_song.wav my_song_master_16bit.wav```
- Get the WAV 16-bit result and save the log file `process.log`
```python3 mg_cli.py my_song.wav some_popular_song.wav my_song_master_16bit.wav --log process.log```
- Get the normalized WAV 24-bit result without applying a limiter
```python3 mg_cli.py target.wav reference.wav result_24bit.wav -b24 --no_limiter```
- Get the non-normalized WAV 32-bit result without applying a limiter
```python3 mg_cli.py target.wav reference.wav result_32bit.wav -b32 --no_limiter --dont_normalize```
##### *Use `python` in Windows instead of `python3`*
Also you can run it without `python3` in front, if `mg_cli.py` has `+x` permission:
```sudo chmod +x mg_cli.py```
And then:
```./mg_cli.py my_song.wav some_popular_song.wav my_song_master_16bit.wav```
```
usage: mg_cli.py [-h] [-b {16,24,32}] [--log LOG] [--no_limiter]
[--dont_normalize]
target reference result
Simple Matchering 2.0 Command Line Application
positional arguments:
target The track you want to master
reference Some "wet" reference track
result Where to save your result
optional arguments:
-h, --help show this help message and exit
-b {16,24,32}, --bit {16,24,32}
The bit depth of your mastered result. 32 means 32-bit
float
--log LOG The file to which the logs will be written
--no_limiter Disables the limiter at the final stage of processing
--dont_normalize Disables normalization, if --no_limiter is set. Can
cause clipping if the bit depth is not 32
```
### Visit **[Matchering main repo][matchering]** to learn more about it!
## A Coffee
If our script saved your time or money, you may:
[](https://pip.me/sergree)
**Thank you!**
[matchering]: https://github.com/sergree/matchering
[anaconda]: https://www.anaconda.com/products/individual#Downloads
[FFmpeg]: https://www.ffmpeg.org/download.html
[path]: https://video.stackexchange.com/questions/20495/how-do-i-set-up-and-use-ffmpeg-in-windows