Skip to content

Commit

Permalink
Update windows.md for latest instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
CarlGao4 authored Nov 14, 2023
1 parent 07845f4 commit 92ffb45
Showing 1 changed file with 17 additions and 8 deletions.
25 changes: 17 additions & 8 deletions docs/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,23 +2,30 @@

## Installation and usage

Parts of the code are untested on Windows (in particular, training a new model). If you don't have much experience with Anaconda, python or the shell, here are more detailed instructions. Note that **Demucs is not supported on 32bits systems** (as Pytorch is not available there).
If you don't have much experience with Anaconda, python or the shell, here are more detailed instructions. Note that **Demucs is not supported on 32bits systems** (as Pytorch is not available there).

- First install Anaconda with **Python 3.8** or more recent, which you can find [here][install].
- Start the [Anaconda prompt][prompt].

Then, all commands that follow must be run from this prompt.

<details>
<summary>I have no coding experience and these are too difficult for me</summary>

> Then a GUI is suitable for you. See [Demucs GUI](https://github.com/CarlGao4/Demucs-Gui)
</details>

### If you want to use your GPU

If you have graphic cards produced by nVidia with more than 6GiB of memory, you can separate tracks with GPU acceleration. To achieve this, you must install Pytorch with CUDA. If Pytorch was already installed (you already installed Demucs for instance), first run `python.exe -m pip uninstall torch torchaudio`.
Then visit [Pytorch Home Page](https://pytorch.org/get-started/locally/) and follow the guide on it to install with CUDA support.
If you have graphic cards produced by NVIDIA with more than 2GiB of memory, you can separate tracks with GPU acceleration. To achieve this, you must install Pytorch with CUDA. If Pytorch was already installed (you already installed Demucs for instance), first run `python.exe -m pip uninstall torch torchaudio`.
Then visit [Pytorch Home Page](https://pytorch.org/get-started/locally/) and follow the guide on it to install with CUDA support. Please make sure that the version of torchaudio should no greater than 2.1 (which is the latest version when this document is written, but 2.2.0 is sure unsupported)

### Installation

Start the Anaconda prompt, and run the following
bash
```

```cmd
conda install -c conda-forge ffmpeg
python.exe -m pip install -U demucs SoundFile
```
Expand All @@ -33,9 +40,12 @@ Then to use Demucs, just start the **Anaconda prompt** and run:
```
demucs -d cpu "PATH_TO_AUDIO_FILE_1" ["PATH_TO_AUDIO_FILE_2" ...]
```
The `"` around the filename are required if the path contains spaces.
The separated files will be under `C:\Users\YOUR_USERNAME\demucs\separated\demucs\`.
The `"` around the filename are required if the path contains spaces. A simple way to input these paths is draging a file from a folder into the terminal.

To find out the separated files, you can run this command and open the folders:
```
explorer separated
```

### Separating an entire folder

Expand All @@ -45,7 +55,6 @@ cd FOLDER
for %i in (*.mp3) do (demucs -d cpu "%i")
```


## Potential errors

If you have an error saying that `mkl_intel_thread.dll` cannot be found, you can try to first run
Expand Down

0 comments on commit 92ffb45

Please sign in to comment.