diff --git a/docs/SpotDL.md b/docs/SpotDL.md index 5cdd37a..a9edb6a 100644 --- a/docs/SpotDL.md +++ b/docs/SpotDL.md @@ -1,9 +1,14 @@ # Basic Usage +First, the program must be downloaded with `pip3` (requires Python 3.6.1 `sudo apt install python3` or higher *and* FFmpeg 4.2 `sudo apt install ffmpeg` or higher) via `pip3 install spotdl`. + To download a track, album, or artist from Spotify, use: `spotdl ` This is non-interactive and works programmatically. +## Using Docker Container +If the host has Docker, but you don't want to install any Python packages, you can run single commands with the Docker container with `docker run --rm -it -v $(pwd):/data coritsky/spotdl `. + # Music Library Integration To make updating my library easier, each "Artist" folder has a file called `spot.txt` which contains only the Spotify URL for that artist. This makes it possible to run a loop similar to the following: @@ -11,7 +16,10 @@ To make updating my library easier, each "Artist" folder has a file called `spot cd /path/to/music/library/artists for artist in */; do cd "$(pwd)/$artist" && - spotdl $(cat spot.txt) && + # use spotdl if the host is already configured with spotdl, or you don't need the script to be portable + # use docker run for better portability (within my lab) at the expense of overhead + spotdl $(cat spot.txt) && + # docker run --rm -it -v $(pwd):/data coritsky/spotdl $(cat spot.txt) && cd .. done ```