homelab/docs/SpotDL.md

1.5 KiB

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 <url e.g. https://open.spotify.com/artist/3q7HBObVc0L8jNeTe5Gofh?si=fd6100828a764c3b>

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 <url e.g. https://open.spotify.com/artist/3q7HBObVc0L8jNeTe5Gofh?si=fd6100828a764c3b>.

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:

cd /path/to/music/library/artists
for artist in */; do
  cd "$(pwd)/$artist" && 
  # 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

Links

coritsky/spotdl on Dockerhub Spotdl on GitHub