SpotFetch :

A simple python program to download Music from various platfroms using yt-dlp ( The audio source is YouTube or YouTube Music ).

What it can do :

• Download Spotify playlists after exporting the playlist as a csv file from Exportify
• batch download music from a .txt file with URLs one by line, or using a custom CSV file with headers name,artist
• Direct download from a Youtube url, can be a video or playlist.
• Downloads from Youtube urls are tagged from MusicBrainz (on by default, configurable in settings): the audio is identified, then proper tags and the album cover are embedded.
• Optional AcoustID fingerprinting for more reliable identification: install fpcalc and set your free API key (from acoustid.org/api-key) in the settings.
• Search then download a song using its name and artist name.
• Optional lyrics embedding from lrclib.net (off by default, configurable in settings): synced LRC lyrics are preferred and embedded as USLT (mp3), ©lyr (m4a), or LYRICS (flac).
• Audio is downloaded as MP3, M4A, or FLAC.
• Songs are downloaded alongside numerous metdata.
• You can use a cookie file in case YouTube rate limits your session.
• Download using either YouTube music or Youtube.
• You can download from platforms other than Spotify if you convert your playlists as CSVs using services like tunemymusic.com .

Installation :

Requirements :

• First make sure you have ffmpeg installed on your machine Download here.
• Install uv.
• If you dont have Git to clone the repo thats fine, you can download it as a zip file and uncompress it, see here.

setup :

• Clone this repository ( or just download it as a zip file and uncompress it ):

git clone https://github.com/MrElyazid/SpotFetch.git

• then :

cd SpotFetch

• setup the project :

uv sync

• now run uv run main.py :

Some details :

Where are my settings saved ?

Settings are persisted automatically in settings.json inside your user config directory (e.g. ~/.config/spotfetch/ on Linux). Delete the file to reset to defaults.

I get track_name error or errors when parsing the csv :

Make sure the language set in Exportify is English.

how to use a cookie file ?:

Use the following extensions to get cookies for YouTube depending on your browser : Chrome, Firefox.

You can read more about using cookies with yt-dlp here Note that you need to have a javascript runtime installed for the cookies to work, deno is recommended, read more here : https://github.com/yt-dlp/yt-dlp/wiki/EJS

Download Platform Selection

• YouTube Music (default): Works best for popular songs and if you don't want to download video clip audio.
• YouTube: Works best for niche and lesser-known songs and artists.

How should the urls txt file look like ?

simply put each link in a line with no quotes, example :

https://youtu.be/dQw4w9WgXcQ?si=zQ_s7NhWcPgEQ46b
https://youtu.be/6-8E4Nirh9s?si=e7LKPptaE6vEEI48
https://music.youtube.com/watch?v=k-3y2LVF_SE&si=G2Dtl4LUbzjGIcpy

How should the custom CSV file look like ?

the headers are name,artist an example :

name,artist
"in the end","linkin park"
"under pressure","queen"
"time","pink floyd"

I keep getting 403 Forbidden Error :

If you get ERROR: unable to download video data: HTTP Error 403: Forbidden when trying to download, this is probably because yt-dlp needs to be updated, you can run uv sync to update the packages.

Contributing :

If you have any enhancement ideas for the program or encountered a bug, you can submit an issue or a PR or start a discussion, happy to help!

License :

SpotFetch is free software licensed under the GPL-2.0-or-later. The tag-search matching (lenient MusicBrainz queries + client-side similarity scoring) is adapted from the MusicBrainz Picard tagger, also GPL-2.0-or-later.