mirror
/
SpotiFile
kopia lustrzana https://github.com/Michael-K-Stein/SpotiFile
1
0
Forkuj 0
Kod Zgłoszenia Packages Projekty Wydania Wiki Aktywność
A simple and open source spotify scraper.
45 Commity
7 Gałęzie
0 Tagi
124 KiB
Python 88%
HTML 7%
CSS 5%
 
 
 
Go to file
Michael Kuperfish Steinberg 8da2468e8d Fix overlapping css 2023-01-20 16:14:34 +02:00
static/css Fix overlapping css 2023-01-20 16:14:34 +02:00
templates Fix typos 2023-01-20 14:27:21 +02:00
utils Fix scraper crash on local files 2023-01-20 15:17:11 +02:00
.gitignore Implement singular track scraping 2023-01-05 15:00:57 +02:00
README.md Update README.md 2023-01-20 13:15:14 +02:00
auto_compressor.py Fix typos 2023-01-20 14:27:21 +02:00
config.py Refactor util classes & functions 2023-01-20 14:11:45 +02:00
exceptions.py Refactor util classes & functions 2023-01-20 14:11:45 +02:00
main.py Fix startup to new name & tab openning 2023-01-05 14:53:09 +02:00
requirements.txt Add modules to requirements file 2023-01-05 14:37:46 +02:00
settings.py Fix merge conflict in settings 2023-01-20 15:20:01 +02:00
spotify_client.py Add more verbose and accurate exceptions 2023-01-20 13:29:08 +02:00
spotify_mass_download.py Fix minor bugs 2023-01-20 14:25:53 +02:00
spotify_scraper.py Fix scraper crash on local files 2023-01-20 15:17:11 +02:00
webgui.py Major bug fixes 2023-01-14 18:48:46 +02:00

README.md

SpotiFile

A simple and open source spotify scraper.

What?

SpotiFile is a script which allows users to simply and easily, using a web-gui, scrape on Spotify playlists, albums, artists, etc. More advanced usages can be done by importing the relevant classes (e.g. from "spotify_scraper import SpotifyScraper") and then using IPython to access specific Spotify API features.

Advantages

The main advantage of using SpotiFile is that it completely circumvents all of Spotify's api call limmits and restrictions. Spotifile offers an API to communicate with Spotify's API as if it were a real user. This allows SpotiFile to download information en-masse quickly.

Why?

Downloading massive amounts of songs and meta data can help if you prefer listening to music offline, or if you are desgining a music server which runs on an airgapped network. We do not encourage music piracy nor condone any illegal activity. SpotiFile is a usefull research tool. Usage of SpotiFile for other purposes is at the user's own risk.

How?

SpotiFile starts its life by authenticating as a normal Spotify user, and then performs a wide range of conventional and unconventional API calls to Spotify in order to retrieve relevant information.

Features

  • Authenticating as a legitimate Spotify user.
  • Scraping tracks from a playlist.
  • Scraping tracks from an album.
  • Scraping tracks from an artist.
  • Scraping a track from a track url.
  • Scraping artist images.
  • Scraping popular playlists' metadata and tracks.
  • Premium user token snatching (experimental).
  • Scraping song lyrics (time synced when possible).
  • Scraping track metadata.

SP_KEY & SP_DC tokens

Obtaining sp_dc and sp_key cookies SpotiFile uses two cookies to authenticate against Spotify in order to have access to the required services. Shoutout to @fondberg for the explanation https://github.com/fondberg/spotcast

To obtain the cookies, these different methods can be used:

Chrome based browser

Open a new Incognito window at https://open.spotify.com and login to Spotify. Press Command+Option+I (Mac) or Control+Shift+I or F12. This should open the developer tools menu of your browser. Go into the application section. In the menu on the left go int Storage/Cookies/open.spotify.com. Find the sp_dc and sp_key and copy the values. Close the window without logging out (Otherwise the cookies are made invalid).

Firefox based browser

Open a new Incognito window at https://open.spotify.com and login to Spotify. Press Command+Option+I (Mac) or Control+Shift+I or F12. This should open the developer tools menu of your browser. Go into the Storage section. (You might have to click on the right arrows to reveal the section). Select the Cookies sub-menu and then https://open.spotify.com. Find the sp_dc and sp_key and copy the values. Close the window without logging out (Otherwise the cookies are made invalid).