/remucs

Demucs wrapper for remixing audio files with additional customizations

Primary LanguagePythonMIT LicenseMIT

Remucs

language license test pypi

The purpose of the remucs command line tool is to extract the individual stems from a mix and remix them again in a certain way, e.g. by adjusting the volume gain, left-right channel balance and last but not least, applying transient-preserving pitch shifting. Since the stem extraction is based on the adefossez/demucs engine, the stem choice is restricted to the drums, bass, vocals and other sources.

Usage

Usage: remucs [OPTIONS] FILES...

Options:
  -f, --fine            Use fine-tuned “htdemucs_ft” model.
  -n, --norm            Normalize output amplitude.
  -m, --mono            Convert stereo input to mono.
  -b, --bala TEXT       Balance of individual stems "bass,drums,other,vocals",
                        e.g. "0,0.5,1,-1". [default: 0,0,0,0]
  -g, --gain TEXT       Gain of individual stems "bass,drums,other,vocals",
                        e.g. "2,1,0.5,0". [default: 1,1,1,1]
  -a, --a4 INTEGER      Target tuning reference frequency, to automatically
                        estimate the pitch shifting factor (experimental).
  -p, --pitch TEXT      Pitch shifting factor in semitones followed by cents,
                        e.g -12 or +12 or +3-50. [default: 0]
  -d, --data DIRECTORY  Directory where to store the intermediate files.
                        [default: <user’s home directory>]
  -q, --quiet           Don't trash stdout.
  -V, --version         Show the version and exit.
  -h, --help            Show this message and exit.

Install

Choose between the latest remucs release or the bleeding edge version:

pip install -U remucs
pip install -U git+https://github.com/jurihock/remucs#egg=remucs

Don't forget to install one of the available versions of demucs as well:

pip install -U demucs
pip install -U git+https://github.com/adefossez/demucs#egg=demucs

License

remucs is licensed under the terms of the MIT license. For details please refer to the accompanying LICENSE file distributed with remucs.