An automation script to download Spotify exported songs using yt-dlp / youtube-dl and FFMPEG.

---

✏️ Key Features

✔️ Customizable
✔️ Parallel downloads
✔️ Full metadata handling
✔️ Imbedded (synchronized) Lyrics
✔️ No additional overhead
✔️ No need to deal with the Spotify API

📃 Legal Notice

Be aware, that this script is only an automation of yt-dlp / youtuble-dl.
All laws regarding the download of copyrighted content also apply here.

📋 Script Setup

1. Visit   Exportify, sign in with your Spotify credentials and export your desired playlists as a .csv file.
2. Install a downloader (yt-dlp or youtube-dl → Check for a recent version! ) and FFMPEG with your prefered package manager. Further tools required that might not be installed: curl, mktemp.
3. Optional: Also install jq and kid3-cli to imbed lyrics.
4. Get the script and make it executable:

wget https://raw.githubusercontent.com/Daenges/Spotify-Downloader-Bash/main/Downloader.sh &&\
chmod +x Downloader.sh

5. Check the script one last time with your favourite editor before execution.

▶️ Script Execution

↪️ ./Downloader.sh "Path/To/YourPlaylist.csv" starts the script with default parameters.

These parameters are:

csvFile=""
downloader=""
processNumber=5
musicPath="./"
additionalKeywords=""

💡 Execution with Parameters: ./Downloader.sh "Path/To/YourPlaylist.csv" --additionalKeywords clean --processNumber 10

Parameter	Usage
csvFile	Must be entered as first parameter on execution and sets the path of your playlist file.
downloader	Sets the download command. There is an automatic detection (prefering yt-dlp), that can be overwritten with: --downloader youtube-dl
processNumber	Number of parallel started Downloadprocesses. Can be altered with: --processNumber 10
musicPath	Sets the path where the music is saved, default is the execution path of the script. Can be changed with: --musicPath /Your/New/Path
additionalKeywords	Since we are performing Youtube Music searches with Title and Author, some additional keywords (e.g. clean, lyrics, ...) might improve the results. Can be set with: --additionalKeywords clean

❌ Errors

If you got any error, check the version of your downloader against their latest release (yt-dlp or youtube-dl). Most errors arise through Youtube updating their page which needs to be implemented into the downloaders. If you have a recent downloader version and still get errors, feel free to create an issue here.

📜 License

Copyright 2025 Daenges

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.