A new look is going to be designed for 1.1, everybody is welcomed to vote in #35
This is a GUI for python project demucs
.
The project aims to let users without any coding experience separate tracks without difficulty. If you have any question about usage or the project, please open an issue to tell us. Since the original project Demucs used scientific library torch
, the packed binaries with environment is very large, and we will only pack binaries for formal releases.
If the application cannot be launched due to the Mac's security protection feature, try the following:
For Windows: At least Windows 8
For Mac: At least macOS 10.15
For Linux: Any system that can install and run python 3.11 (Because I'll pack the binaries using python 3.11)
Memory: About at least 8GB of total memory (physical and swap) would be required. The longer the track you want to separate, the more memory will be required.
GPU: Only NVIDIA GPUs (whose compute capability should be at least 3.5) and Apple MPS are supported. At least 2GB of private memory is required.
At least Python 3.9 is required. Other requirements please refer to Installing binaries.
Binaries for download are available here.
Please refer to history.md.
If you are using released binaries, please refer to usage.md
This part is written for beta versions
According to Apple Developer Forums, the crash is caused by manipulating the GUI from a thread other than the main thread. This is exactly what Demucs GUI does: the separation process is time-consuming, so it is run in a separate thread to avoid causing the main window to stop responding. This thread will manipulate the GUI to update the progress bar and retrieve separation parameters from time to time.
But it's strange that the crash only happens on Apple Silicon Macs. Besides, Demucs GUI manipulates the GUI from a separate thread more than once, but the crash only happens when loading a model if you've chosen another model (as long as you've opened the drop-down menu for choosing models even if you didn't choose another model). So the solution is to run Python x86_64 using Rosetta 2, or wait for the bug to be fixed.
pip
, conda
or other package managers to install all packages in requirements.txt.# For pip
pip install -r requirements.txt
# For conda
conda install --yes --file requirements.txt
GuiMain.py
and separate your song!pip
, conda
or other package managers to install all packages in requirements_cuda.txt.# For pip
pip install -r requirements_cuda.txt
# Conda is not available as this project has dependencies only on PyPI
GuiMain.py
and separate your song! If your GPU is not listed in the device
column, or is labeled "not recommended", this means your GPU is not available or the VRAM is not enough. Please use CPU instead or open an issue to tell us if you think this is a problem.This project includes code of Demucs under MIT license.