Skip to content
thooore edited this page Nov 20, 2021 · 10 revisions

Welcome to the SpleeterGUI wiki!


Installation

  1. Download the compiled binary folder from GitHub releases and place it wherever you want.
  2. Download and extract SpleeterCore
  3. Start SpleeterGUI (There could be an error message showing here, continue anyway!)
  4. In SpleeterGUI select Advanced > Set SpleeterGUI Core path and select the path to where you unzipped SpleeterCore (The root_folder.txt of SpleeterCore should be in that folder)
  5. Restart SpleeterGUI

You should do this even if you ran the original branch of SpleeterGUI, since you won't have the binaries needed for generating stems. It also makes sure you have an up-to-date version of Spleeter, since Deezer changed how the inputs are sent in version 2.1.0.

If you want a similar program for Mac you should check out Stemgen or Spleet-It.


Help & FAQ

Check out this project's help page or the original developer's help page for more info.

If you are having trouble getting things to work, see if there is an issue that solves it, otherwise create a new one! (You can also see if there is an issue that solves it on the original GitHub project page)

There will most likely be a popup saying "Error: Unable to find python.exe" the first time when using the program. Setting the SpleeterCore path should fix this.

Do not change the settings while the program is running.

Please notice that the NI Stem files created with this program can be a bit weird since they are not official files. They do not have any cover art and need to be analyzed in Traktor before they are played.


What the buttons do

SpleeterGUI

  • Parts to separate - Select how many stems you want the output to be.

  • Recombine (Merge output parts back together) - Takes the output parts you select and mix them back together into one file. Mostly useful if you do not have access to other audio software.

  • Full bandwidth (16kHz High quality) - Makes Spleeter perform separation up to 16kHz instead of 11kHz. You most likely want this enabled.

  • Maximum song length - I believe large files take up a lot of memory and can cause Spleeter to crash. Setting this allows Spleeter to only separate the first part of a large file to keep it from crashing. You most likely do not need to change this from 600 seconds. (If you have very large files you might need to use something like this instead of this program)

  • Save to - Select where you want the output files to end up!

  • Write input name to output files - Adds the original file's name to the output files to help organize things.

  • Output codec - Allows you to export different types of files from the program. wav-files are usually good if you want to use them in other software.

  • Bitrate - Allows you to change the bitrate for formats that support it (mp3, ogg, m4a and wma).

NI Stem builder

Creating a NI Stem overrides many of the settings in the program.

  • Generate NI Stem - Creates a normal 4-stem file that can be used in Native Instruments Traktor.

  • Generate NI Container from two stems - Ignores two stems and creates a 2-stem file that can be used in Native Instruments Traktor. Should be a little bit faster than creating a 4-stem file.

  • Remove Working Files - Removes the intermediary m4a files that are created in the while making a stem file. The intermediary files are regular audio files that can be used into other software, but removing them should help keep your Traktor Collection a bit more clean.

  • Save to 'stems' Folder - Places your stems in a 'stems' folder so you can avoid Traktor importing non-stems into your collection. This way you can add only the 'stems' folder in Traktor's File Management settings.

Toolbar

File

  • Exit - A fancy way to close the program.

Language

  • Select what language you want. Most of them are pretty broken after I added more buttons and settings. If you want to fix them create a pull request!

Advanced

  • Set SpleeterGUI Core path - Set the path to where you downloaded SpleeterCore. These folder should contain all the files necessary for running source separation.

  • Update Spleeter version - Runs a command that tells PyPi to download and update the Spleeter version.

Help


The changes from the original SpleeterGUI project to this one can be seen by looking at the git diff if you are interested in that sort of stuff.