[Feature] Improve documentation on Docker

[justin-hackin]

Description

First of all, the command in the readme doesn't work, it should use deezer/spleeter:3.8 because latest doesn't exist (I saw logged issue).

Secondly, I'm not very familiar with windows shells and there's no instructions. After carefully setting up paths I'm trying to run in Powershell

 docker run  -v $Env:SPLEETER_INPUT:/input -v $Env:SPLEETER_OUTPUT:/output -v $Env:SPLEETER_MODEL:/model -e MODEL_PATH=/model deezer/spleeter:3.8 separate -o /output /input/test.mp3

and I get

Error: Invalid value for 'FILES...': File '/input/test.mp3' does not exist.

I also tried using ${VAR_NAME} and also surrounding each variant with quotes but this didn't seem to help.

so then I went to cmd.exe and did

run  -v %SPLEETER_INPUT%:/input -v %SPLEETER_OUTPUT%:/output -v %SPLEETER_MODEL%:/model -e MODEL_PATH=/model deezer/spleeter:3.8 separate -o /output /input/test.mp3
docker: invalid reference format.
See 'docker run --help'.

but I get the same reference error.

[fiskhandlarn]

+1. I'm getting the exact same problem.

[amamenko]

+1 as well to better Docker documentation. The way I've gotten the separation process to work via Docker is as follows. Let's say you have a directory within your root called /inputs. This directory contains an MP3 file called test_audio.mp3. From the root directory, you would run the following command:

docker run -v $(pwd)/inputs:/input -v $(pwd)/output:/output deezer/spleeter:3.8 separate -o /output /input/test_audio.mp3

The /inputs directory that you've added as a container volume is aliased as /input. Therefore, when supplying the actual input filename as an argument to the separate command, you would supply it as /input/test_audio.mp3.

This then creates an /output directory within your root directory with a /test_audio directory within it containing two separated files - accompaniment.wav and vocals.wav.

[Foul-Tarnished]

I still get invalid reference format man docker is garbage, just let me paste the absolute path of my flac file

what do you even mean by "the" root directory smh

F:\Spleeter>

docker run -v $(pwd)/inputs:/input -v $(pwd)/output:/output deezer/spleeter:3.8-2stems separate -o /output /input/imaginary_folklore.flac
docker: invalid reference format.

[brunoimbrizi]

In the Wiki > 2. Getting Started > Using Docker image, this is the command line to run the GPU version:

# Or if your docker client version is high enough to support `Nvidia` runtime :
docker run --runtime=nvidia -v $(pwd)/output:/output deezer/spleeter-gpu separate -o /output audio_example.mp3

Error: docker: Error response from daemon: unknown or invalid runtime name: nvidia.

Fix (found in the NVIDIA/nvidia-docker issues):

maybe --gpus all instead of --runtime=nvidia

Error: docker: Error response from daemon: manifest for deezer/spleeter-gpu:latest not found: manifest unknown: manifest unknown.

Fix (check valid Docker Hub tags): Append version i.e. 3.8: deezer/spleeter-gpu:3.8

Working command line:

docker run --gpus all -v $(pwd)/output:/output deezer/spleeter-gpu:3.8 separate -o /output audio_example.mp3