Installation

Stemgen is a Python CLI. Please make sure to have Python 3.9 or higher installed on your system. You also need Git.

Once you have Python and Git installed, you can download Stemgen:

git clone https://github.com/axeldelafosse/stemgen.git

Note

Some operating systems might be equipped with the python3 and pip3 commands instead of python and pip (but they should be equivalent). If you don’t have pip or pip3 available in your system, please check out the pip installation docs.

macOS

python3 -m pip install -U demucs

python3 -m pip install mutagen

brew install coreutils ffmpeg sox

Windows

python3 -m pip install -U demucs

python3 -m pip install mutagen

Download ffmpeg from https://www.ffmpeg.org/download.html
Download sox from https://sourceforge.net/projects/sox/files/sox
Add ffmpeg and sox to your PATH

Note that you might need Microsoft C++ Build Tools for Demucs.

qaac

If you plan to encode in AAC, you should install qaac. Here is a quick guide:

Download qaac from https://github.com/nu774/qaac/releases
Move the content of x64 to C:\Program Files\qaac (or x86 depending on your system)
Add C:\Program Files\qaac to your PATH

Then, to use Audio Toolbox from Apple:

git clone https://github.com/nu774/makeportable.git

cd makeportable

Download the iTunes installer from https://www.apple.com/itunes/download/win64
Copy the iTunes installer to the makeportable folder

makeportable.cmd

Copy the newly created folder QTfiles64 to your C:\Program Files\qaac folder

Then, to support FLAC files:

Download FLAC from https://github.com/xiph/flac/releases
Copy the libFLAC.dll file from the Win64 folder (or Win32 depending on your system)
Paste it in your C:\Program Files\qaac folder

Enjoy! You can now encode AAC stems with Apple Audio Toolbox, the highest quality AAC encoder.

Linux

python3 -m pip install -U demucs

python3 -m pip install mutagen

sudo apt install ffmpeg sox

If you plan to encode in AAC on Linux, you should consider installing ffmpeg with the --enable-libfdk-aac flag to use the highest quality AAC encoder.

You can use https://github.com/markus-perl/ffmpeg-build-script in order to do this easily.