mirror of
https://github.com/THIS-IS-NOT-A-BACKUP/zspotify.git
synced 2024-11-26 09:53:17 +01:00
886 lines
31 KiB
Python
Executable File
886 lines
31 KiB
Python
Executable File
#! /usr/bin/env python3
|
|
|
|
"""
|
|
ZSpotify
|
|
It's like youtube-dl, but for Spotify.
|
|
|
|
(Made by Deathmonger/Footsiefat - @doomslayer117:matrix.org)
|
|
"""
|
|
|
|
from getpass import getpass
|
|
import json
|
|
import os
|
|
import os.path
|
|
import platform
|
|
import re
|
|
import sys
|
|
import time
|
|
|
|
from librespot.audio.decoders import AudioQuality, VorbisOnlyAudioQuality
|
|
from librespot.core import Session
|
|
from librespot.metadata import TrackId, EpisodeId
|
|
import music_tag
|
|
from pydub import AudioSegment
|
|
import requests
|
|
from tqdm import tqdm
|
|
|
|
QUALITY = None
|
|
SESSION: Session = None
|
|
SANITIZE = ["\\", "/", ":", "*", "?", "'", "<", ">", "\""]
|
|
|
|
# user-customizable variables that adjust the core functionality of ZSpotify
|
|
with open("zs_config.json", encoding="utf-8") as config_file:
|
|
ZS_CONFIG = json.load(config_file)
|
|
|
|
|
|
# miscellaneous functions for general use
|
|
|
|
|
|
def clear():
|
|
""" Clear the console window """
|
|
if platform.system() == "Windows":
|
|
os.system("cls")
|
|
else:
|
|
os.system("clear")
|
|
|
|
|
|
def wait(seconds: int = 3):
|
|
""" Pause for a set number of seconds """
|
|
for i in range(seconds)[::-1]:
|
|
print(f"\rWait for {i + 1} second(s)...", end="")
|
|
time.sleep(1)
|
|
|
|
|
|
def sanitize_data(value):
|
|
""" Returns given string with problematic removed """
|
|
for i in SANITIZE:
|
|
value = value.replace(i, "")
|
|
return value.replace("|", "-")
|
|
|
|
|
|
def split_input(selection):
|
|
""" Returns a list of inputted strings """
|
|
inputs = []
|
|
if "-" in selection:
|
|
for number in range(int(selection.split("-")[0]), int(selection.split("-")[1]) + 1):
|
|
inputs.append(number)
|
|
else:
|
|
selections = selection.split(",")
|
|
for i in selections:
|
|
inputs.append(i.strip())
|
|
return inputs
|
|
|
|
|
|
def splash():
|
|
""" Displays splash screen """
|
|
print("""
|
|
███████ ███████ ██████ ██████ ████████ ██ ███████ ██ ██
|
|
███ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
|
|
███ ███████ ██████ ██ ██ ██ ██ █████ ████
|
|
███ ██ ██ ██ ██ ██ ██ ██ ██
|
|
███████ ███████ ██ ██████ ██ ██ ██ ██
|
|
""")
|
|
|
|
|
|
# two mains functions for logging in and doing client stuff
|
|
def login():
|
|
""" Authenticates with Spotify and saves credentials to a file """
|
|
global SESSION # pylint: disable=global-statement
|
|
|
|
if os.path.isfile("credentials.json"):
|
|
try:
|
|
SESSION = Session.Builder().stored_file().create()
|
|
return
|
|
except RuntimeError:
|
|
pass
|
|
while True:
|
|
user_name = input("Username: ")
|
|
password = getpass()
|
|
try:
|
|
SESSION = Session.Builder().user_pass(user_name, password).create()
|
|
return
|
|
except RuntimeError:
|
|
pass
|
|
|
|
|
|
def client(): # pylint: disable=too-many-branches,too-many-statements
|
|
""" Connects to spotify to perform query's and get songs to download """
|
|
global QUALITY # pylint: disable=global-statement
|
|
splash()
|
|
|
|
token = SESSION.tokens().get("user-read-email")
|
|
|
|
if check_premium():
|
|
print("[ DETECTED PREMIUM ACCOUNT - USING VERY_HIGH QUALITY ]\n\n")
|
|
QUALITY = AudioQuality.VERY_HIGH
|
|
else:
|
|
print("[ DETECTED FREE ACCOUNT - USING HIGH QUALITY ]\n\n")
|
|
QUALITY = AudioQuality.HIGH
|
|
|
|
while True:
|
|
if len(sys.argv) > 1:
|
|
if sys.argv[1] == "-p" or sys.argv[1] == "--playlist":
|
|
download_from_user_playlist()
|
|
elif sys.argv[1] == "-ls" or sys.argv[1] == "--liked-songs":
|
|
for song in get_saved_tracks(token):
|
|
if not song["track"]["name"]:
|
|
print(
|
|
"### SKIPPING: SONG DOES NOT EXISTS ON SPOTIFY ANYMORE ###")
|
|
else:
|
|
download_track(song["track"]["id"], "Liked Songs/")
|
|
print("\n")
|
|
else:
|
|
track_id_str, album_id_str, playlist_id_str, episode_id_str, show_id_str, artist_id_str = regex_input_for_urls(
|
|
sys.argv[1])
|
|
|
|
if track_id_str is not None:
|
|
download_track(track_id_str)
|
|
elif artist_id_str is not None:
|
|
download_artist_albums(artist_id_str)
|
|
elif album_id_str is not None:
|
|
download_album(album_id_str)
|
|
elif playlist_id_str is not None:
|
|
playlist_songs = get_playlist_songs(token, playlist_id_str)
|
|
name, _ = get_playlist_info(token, playlist_id_str)
|
|
for song in playlist_songs:
|
|
download_track(song["track"]["id"],
|
|
sanitize_data(name) + "/")
|
|
print("\n")
|
|
elif episode_id_str is not None:
|
|
download_episode(episode_id_str)
|
|
elif show_id_str is not None:
|
|
for episode in get_show_episodes(token, show_id_str):
|
|
download_episode(episode)
|
|
else:
|
|
search_text = input("Enter search or URL: ")
|
|
|
|
track_id_str, album_id_str, playlist_id_str, episode_id_str, show_id_str, artist_id_str = regex_input_for_urls(
|
|
search_text)
|
|
|
|
if track_id_str is not None:
|
|
download_track(track_id_str)
|
|
elif artist_id_str is not None:
|
|
download_artist_albums(artist_id_str)
|
|
elif album_id_str is not None:
|
|
download_album(album_id_str)
|
|
elif playlist_id_str is not None:
|
|
playlist_songs = get_playlist_songs(token, playlist_id_str)
|
|
name, _ = get_playlist_info(token, playlist_id_str)
|
|
for song in playlist_songs:
|
|
download_track(song["track"]["id"],
|
|
sanitize_data(name) + "/")
|
|
print("\n")
|
|
elif episode_id_str is not None:
|
|
download_episode(episode_id_str)
|
|
elif show_id_str is not None:
|
|
for episode in get_show_episodes(token, show_id_str):
|
|
download_episode(episode)
|
|
else:
|
|
search(search_text)
|
|
# wait()
|
|
|
|
|
|
def regex_input_for_urls(search_input): # pylint: disable=too-many-locals
|
|
""" Since many kinds of search may be passed at the command line, process them all here. """
|
|
track_uri_search = re.search(
|
|
r"^spotify:track:(?P<TrackID>[0-9a-zA-Z]{22})$", search_input)
|
|
track_url_search = re.search(
|
|
r"^(https?://)?open\.spotify\.com/track/(?P<TrackID>[0-9a-zA-Z]{22})(\?si=.+?)?$",
|
|
search_input,
|
|
)
|
|
|
|
album_uri_search = re.search(
|
|
r"^spotify:album:(?P<AlbumID>[0-9a-zA-Z]{22})$", search_input)
|
|
album_url_search = re.search(
|
|
r"^(https?://)?open\.spotify\.com/album/(?P<AlbumID>[0-9a-zA-Z]{22})(\?si=.+?)?$",
|
|
search_input,
|
|
)
|
|
|
|
playlist_uri_search = re.search(
|
|
r"^spotify:playlist:(?P<PlaylistID>[0-9a-zA-Z]{22})$", search_input)
|
|
playlist_url_search = re.search(
|
|
r"^(https?://)?open\.spotify\.com/playlist/(?P<PlaylistID>[0-9a-zA-Z]{22})(\?si=.+?)?$",
|
|
search_input,
|
|
)
|
|
|
|
episode_uri_search = re.search(
|
|
r"^spotify:episode:(?P<EpisodeID>[0-9a-zA-Z]{22})$", search_input)
|
|
episode_url_search = re.search(
|
|
r"^(https?://)?open\.spotify\.com/episode/(?P<EpisodeID>[0-9a-zA-Z]{22})(\?si=.+?)?$",
|
|
search_input,
|
|
)
|
|
|
|
show_uri_search = re.search(
|
|
r"^spotify:show:(?P<ShowID>[0-9a-zA-Z]{22})$", search_input)
|
|
show_url_search = re.search(
|
|
r"^(https?://)?open\.spotify\.com/show/(?P<ShowID>[0-9a-zA-Z]{22})(\?si=.+?)?$",
|
|
search_input,
|
|
)
|
|
|
|
artist_uri_search = re.search(
|
|
r"^spotify:artist:(?P<ArtistID>[0-9a-zA-Z]{22})$", search_input)
|
|
artist_url_search = re.search(
|
|
r"^(https?://)?open\.spotify\.com/artist/(?P<ArtistID>[0-9a-zA-Z]{22})(\?si=.+?)?$",
|
|
search_input,
|
|
)
|
|
|
|
if track_uri_search is not None or track_url_search is not None:
|
|
track_id_str = (track_uri_search
|
|
if track_uri_search is not None else
|
|
track_url_search).group("TrackID")
|
|
else:
|
|
track_id_str = None
|
|
|
|
if album_uri_search is not None or album_url_search is not None:
|
|
album_id_str = (album_uri_search
|
|
if album_uri_search is not None else
|
|
album_url_search).group("AlbumID")
|
|
else:
|
|
album_id_str = None
|
|
|
|
if playlist_uri_search is not None or playlist_url_search is not None:
|
|
playlist_id_str = (playlist_uri_search
|
|
if playlist_uri_search is not None else
|
|
playlist_url_search).group("PlaylistID")
|
|
else:
|
|
playlist_id_str = None
|
|
|
|
if episode_uri_search is not None or episode_url_search is not None:
|
|
episode_id_str = (episode_uri_search
|
|
if episode_uri_search is not None else
|
|
episode_url_search).group("EpisodeID")
|
|
else:
|
|
episode_id_str = None
|
|
|
|
if show_uri_search is not None or show_url_search is not None:
|
|
show_id_str = (show_uri_search
|
|
if show_uri_search is not None else
|
|
show_url_search).group("ShowID")
|
|
else:
|
|
show_id_str = None
|
|
|
|
if artist_uri_search is not None or artist_url_search is not None:
|
|
artist_id_str = (artist_uri_search
|
|
if artist_uri_search is not None else
|
|
artist_url_search).group("ArtistID")
|
|
else:
|
|
artist_id_str = None
|
|
|
|
return track_id_str, album_id_str, playlist_id_str, episode_id_str, show_id_str, artist_id_str
|
|
|
|
|
|
def get_episode_info(episode_id_str): # pylint: disable=missing-function-docstring
|
|
token = SESSION.tokens().get("user-read-email")
|
|
info = json.loads(requests.get(f"https://api.spotify.com/v1/episodes/{episode_id_str}",
|
|
headers={"Authorization": f"Bearer {token}"}).text)
|
|
|
|
if "error" in info:
|
|
return None, None
|
|
# print(info["images"][0]["url"])
|
|
return sanitize_data(info["show"]["name"]), sanitize_data(info["name"])
|
|
|
|
|
|
def get_show_episodes(access_token, show_id_str): # pylint: disable=missing-function-docstring
|
|
episodes = []
|
|
|
|
headers = {"Authorization": f"Bearer {access_token}"}
|
|
resp = requests.get(
|
|
f"https://api.spotify.com/v1/shows/{show_id_str}/episodes", headers=headers).json()
|
|
|
|
for episode in resp["items"]:
|
|
episodes.append(episode["id"])
|
|
|
|
return episodes
|
|
|
|
|
|
def download_episode(episode_id_str): # pylint: disable=missing-function-docstring
|
|
podcast_name, episode_name = get_episode_info(episode_id_str)
|
|
|
|
extra_paths = podcast_name + "/"
|
|
|
|
if podcast_name is None:
|
|
print("### SKIPPING: (EPISODE NOT FOUND) ###")
|
|
else:
|
|
filename = podcast_name + " - " + episode_name
|
|
|
|
episode_id = EpisodeId.from_base62(episode_id_str)
|
|
stream = SESSION.content_feeder().load(
|
|
episode_id, VorbisOnlyAudioQuality(QUALITY), False, None)
|
|
# print("### DOWNLOADING '" + podcast_name + " - " +
|
|
# episode_name + "' - THIS MAY TAKE A WHILE ###")
|
|
|
|
os.makedirs(ZS_CONFIG["ROOT_PODCAST_PATH"] +
|
|
extra_paths, exist_ok=True)
|
|
|
|
total_size = stream.input_stream.size
|
|
with open(ZS_CONFIG["ROOT_PODCAST_PATH"] + extra_paths + filename + ".wav", "wb") as file, tqdm(
|
|
desc=filename,
|
|
total=total_size,
|
|
unit="B",
|
|
unit_scale=True,
|
|
unit_divisor=1024
|
|
) as p_bar:
|
|
for _ in range(int(total_size / ZS_CONFIG["CHUNK_SIZE"]) + 1):
|
|
p_bar.update(file.write(
|
|
stream.input_stream.stream().read(ZS_CONFIG["CHUNK_SIZE"])))
|
|
|
|
# convert_audio_format(ZS_CONFIG["ROOT_PODCAST_PATH"] +
|
|
# extra_paths + filename + ".wav")
|
|
|
|
# related functions that do stuff with the spotify API
|
|
|
|
|
|
def search(search_term): # pylint: disable=too-many-locals,too-many-branches
|
|
""" Searches Spotify's API for relevant data """
|
|
token = SESSION.tokens().get("user-read-email")
|
|
|
|
params = {
|
|
"limit" : "10",
|
|
"q" : search_term,
|
|
"type" : set(),
|
|
}
|
|
|
|
# Block for parsing passed arguments
|
|
splits = search_term.split()
|
|
for split in splits:
|
|
index = splits.index(split)
|
|
|
|
if split[0] == "-" and len(split) > 1:
|
|
if len(splits)-1 == index:
|
|
raise IndexError("No parameters passed after option: {}\n".
|
|
format(split))
|
|
|
|
if split == "-l" or split == "-limit":
|
|
try:
|
|
int(splits[index+1])
|
|
except ValueError:
|
|
raise ValueError("Paramater passed after {} option must be an integer.\n".
|
|
format(split))
|
|
if int(splits[index+1]) > 50:
|
|
raise ValueError("Invalid limit passed. Max is 50.\n")
|
|
params["limit"] = splits[index+1]
|
|
|
|
|
|
if split == "-t" or split == "-type":
|
|
|
|
allowed_types = ["track", "playlist", "album", "artist"]
|
|
for i in range(index+1, len(splits)):
|
|
if splits[i][0] == "-":
|
|
break
|
|
|
|
if splits[i] not in allowed_types:
|
|
raise ValueError("Parameters passed after {} option must be from this list:\n{}".
|
|
format(split, '\n'.join(allowed_types)))
|
|
|
|
params["type"].add(splits[i])
|
|
|
|
if len(params["type"]) == 0:
|
|
params["type"] = {"track", "album", "playlist", "artist"}
|
|
|
|
# Clean search term
|
|
search_term_list = []
|
|
for split in splits:
|
|
if split[0] == "-":
|
|
break
|
|
search_term_list.append(split)
|
|
if not search_term_list:
|
|
raise ValueError("Invalid query.")
|
|
params["q"] = ' '.join(search_term_list)
|
|
|
|
resp = requests.get(
|
|
"https://api.spotify.com/v1/search",
|
|
{
|
|
"limit": params["limit"],
|
|
"offset": "0",
|
|
"q": params["q"],
|
|
"type": ",".join(params["type"])
|
|
},
|
|
headers={"Authorization": f"Bearer {token}"},
|
|
)
|
|
|
|
# print(resp.json())
|
|
|
|
enum = 1
|
|
dics = []
|
|
|
|
# add all returned tracks to dics
|
|
if "track" in params["type"]:
|
|
tracks = resp.json()["tracks"]["items"]
|
|
if len(tracks) > 0:
|
|
print("### TRACKS ###")
|
|
for track in tracks:
|
|
if track["explicit"]:
|
|
explicit = "[E]"
|
|
else:
|
|
explicit = ""
|
|
# collect needed data
|
|
dic = {
|
|
"id" : track["id"],
|
|
"name" : track["name"],
|
|
"artists/owner" : [artist["name"] for artist in track["artists"]],
|
|
"type" : "track",
|
|
}
|
|
dics.append(dic)
|
|
|
|
print("{}, {} {} | {}".format(
|
|
enum,
|
|
dic["name"],
|
|
explicit,
|
|
",".join(dic["artists/owner"]),
|
|
))
|
|
enum += 1
|
|
total_tracks = enum - 1
|
|
print("\n")
|
|
# free up memory
|
|
del tracks
|
|
else:
|
|
total_tracks = 0
|
|
|
|
if "album" in params["type"]:
|
|
albums = resp.json()["albums"]["items"]
|
|
if len(albums) > 0:
|
|
print("### ALBUMS ###")
|
|
for album in albums:
|
|
# collect needed data
|
|
dic = {
|
|
"id" : album["id"],
|
|
"name" : album["name"],
|
|
"artists/owner" : [artist["name"] for artist in album["artists"]],
|
|
"type" : "album",
|
|
}
|
|
dics.append(dic)
|
|
|
|
print("{}, {} | {}".format(
|
|
enum,
|
|
dic["name"],
|
|
",".join(dic["artists/owner"]),
|
|
))
|
|
enum += 1
|
|
total_albums = enum - total_tracks - 1
|
|
print("\n")
|
|
# free up memory
|
|
del albums
|
|
else:
|
|
total_albums = 0
|
|
|
|
if "playlist" in params["type"]:
|
|
playlists = resp.json()["playlists"]["items"]
|
|
if len(playlists) > 0:
|
|
print("### PLAYLISTS ###")
|
|
for playlist in playlists:
|
|
# collect needed data
|
|
dic = {
|
|
"id" : playlist["id"],
|
|
"name" : playlist["name"],
|
|
"artists/owner" : [playlist["owner"]["display_name"]],
|
|
"type" : "playlist",
|
|
}
|
|
dics.append(dic)
|
|
|
|
print("{}, {} | {}".format(
|
|
enum,
|
|
dic["name"],
|
|
",".join(dic['artists/owner']),
|
|
))
|
|
|
|
enum += 1
|
|
total_playlists = enum - total_tracks - total_albums - 1
|
|
print("\n")
|
|
# free up memory
|
|
del playlists
|
|
else:
|
|
total_playlists = 0
|
|
|
|
if "artist" in params["type"]:
|
|
artists = resp.json()["artists"]["items"]
|
|
if len(artists) > 0:
|
|
print("### ARTISTS ###")
|
|
for artist in artists:
|
|
# collect needed data
|
|
dic = {
|
|
"id" : artist["id"],
|
|
"name" : artist["name"],
|
|
"type" : "artist",
|
|
}
|
|
dics.append(dic)
|
|
|
|
print("{}, {}".format(
|
|
enum,
|
|
dic["name"],
|
|
))
|
|
|
|
enum += 1
|
|
total_artists = enum - total_tracks - total_albums - total_playlists - 1
|
|
print("\n")
|
|
else:
|
|
total_artists = 0
|
|
|
|
if total_tracks + total_albums + total_playlists + total_artists == 0:
|
|
print("NO RESULTS FOUND - EXITING...")
|
|
else:
|
|
selection = str(input("SELECT ITEM(S) BY ID: "))
|
|
inputs = split_input(selection)
|
|
for pos in inputs:
|
|
position = int(pos)
|
|
for dic in dics:
|
|
# find dictionary
|
|
print_pos = dics.index(dic) + 1
|
|
if print_pos == position:
|
|
# if request is for track
|
|
if dic["type"] == "track":
|
|
download_track(dic["id"])
|
|
# if request is for album
|
|
if dic["type"] == "album":
|
|
download_album(dic["id"])
|
|
# if request is for artist
|
|
if dic["type"] == "artist":
|
|
download_artist_albums(dic["id"])
|
|
# if request is for playlist
|
|
if dic["type"] == "playlist":
|
|
playlist_songs = get_playlist_songs(token, dic["id"])
|
|
for song in playlist_songs:
|
|
if song["track"]["id"] is not None:
|
|
download_track(song["track"]["id"],
|
|
sanitize_data(dic["name"].strip()) + "/")
|
|
print("\n")
|
|
|
|
|
|
def get_song_info(song_id):
|
|
""" Retrieves metadata for downloaded songs """
|
|
token = SESSION.tokens().get("user-read-email")
|
|
|
|
info = json.loads(requests.get("https://api.spotify.com/v1/tracks?ids=" + song_id +
|
|
"&market=from_token", headers={"Authorization": f"Bearer {token}"}).text)
|
|
|
|
artists = []
|
|
for data in info["tracks"][0]["artists"]:
|
|
artists.append(sanitize_data(data["name"]))
|
|
album_name = sanitize_data(info["tracks"][0]["album"]["name"])
|
|
name = sanitize_data(info["tracks"][0]["name"])
|
|
image_url = info["tracks"][0]["album"]["images"][0]["url"]
|
|
release_year = info["tracks"][0]["album"]["release_date"].split("-")[0]
|
|
disc_number = info["tracks"][0]["disc_number"]
|
|
track_number = info["tracks"][0]["track_number"]
|
|
scraped_song_id = info["tracks"][0]["id"]
|
|
is_playable = info["tracks"][0]["is_playable"]
|
|
|
|
return artists, album_name, name, image_url, release_year, disc_number, track_number, scraped_song_id, is_playable
|
|
|
|
|
|
def check_premium():
|
|
""" If user has spotify premium return true """
|
|
return bool((SESSION.get_user_attribute("type") == "premium") or ZS_CONFIG["FORCE_PREMIUM"])
|
|
|
|
|
|
# Functions directly related to modifying the downloaded audio and its metadata
|
|
def convert_audio_format(filename):
|
|
""" Converts raw audio into playable mp3 or ogg vorbis """
|
|
# print("### CONVERTING TO " + ZS_CONFIG["MUSIC_FORMAT"].upper() + " ###")
|
|
raw_audio = AudioSegment.from_file(filename, format="ogg",
|
|
frame_rate=44100, channels=2, sample_width=2)
|
|
if QUALITY == AudioQuality.VERY_HIGH:
|
|
bitrate = "320k"
|
|
else:
|
|
bitrate = "160k"
|
|
raw_audio.export(
|
|
filename, format=ZS_CONFIG["MUSIC_FORMAT"], bitrate=bitrate)
|
|
|
|
|
|
def set_audio_tags(filename, artists, name, album_name, release_year, disc_number, track_number): # pylint: disable=too-many-arguments
|
|
""" sets music_tag metadata """
|
|
# print("### SETTING MUSIC TAGS ###")
|
|
tags = music_tag.load_file(filename)
|
|
tags["artist"] = conv_artist_format(artists)
|
|
tags["tracktitle"] = name
|
|
tags["album"] = album_name
|
|
tags["year"] = release_year
|
|
tags["discnumber"] = disc_number
|
|
tags["tracknumber"] = track_number
|
|
tags.save()
|
|
|
|
|
|
def set_music_thumbnail(filename, image_url):
|
|
""" Downloads cover artwork """
|
|
# print("### SETTING THUMBNAIL ###")
|
|
img = requests.get(image_url).content
|
|
tags = music_tag.load_file(filename)
|
|
tags["artwork"] = img
|
|
tags.save()
|
|
|
|
|
|
def conv_artist_format(artists):
|
|
""" Returns converted artist format """
|
|
formatted = ""
|
|
for artist in artists:
|
|
formatted += artist + ", "
|
|
return formatted[:-2]
|
|
|
|
|
|
# Extra functions directly related to spotify playlists
|
|
def get_all_playlists(access_token):
|
|
""" Returns list of users playlists """
|
|
playlists = []
|
|
limit = 50
|
|
offset = 0
|
|
|
|
while True:
|
|
headers = {"Authorization": f"Bearer {access_token}"}
|
|
params = {"limit": limit, "offset": offset}
|
|
resp = requests.get("https://api.spotify.com/v1/me/playlists",
|
|
headers=headers, params=params).json()
|
|
offset += limit
|
|
playlists.extend(resp["items"])
|
|
|
|
if len(resp["items"]) < limit:
|
|
break
|
|
|
|
return playlists
|
|
|
|
|
|
def get_playlist_songs(access_token, playlist_id):
|
|
""" returns list of songs in a playlist """
|
|
songs = []
|
|
offset = 0
|
|
limit = 100
|
|
|
|
while True:
|
|
headers = {"Authorization": f"Bearer {access_token}"}
|
|
params = {"limit": limit, "offset": offset}
|
|
resp = requests.get(
|
|
f"https://api.spotify.com/v1/playlists/{playlist_id}/tracks", headers=headers, params=params).json()
|
|
offset += limit
|
|
songs.extend(resp["items"])
|
|
|
|
if len(resp["items"]) < limit:
|
|
break
|
|
|
|
return songs
|
|
|
|
|
|
def get_playlist_info(access_token, playlist_id):
|
|
""" Returns information scraped from playlist """
|
|
headers = {"Authorization": f"Bearer {access_token}"}
|
|
resp = requests.get(
|
|
f"https://api.spotify.com/v1/playlists/{playlist_id}?fields=name,owner(display_name)&market=from_token",
|
|
headers=headers).json()
|
|
return resp["name"].strip(), resp["owner"]["display_name"].strip()
|
|
|
|
|
|
# Extra functions directly related to spotify albums
|
|
def get_album_tracks(access_token, album_id):
|
|
""" Returns album tracklist """
|
|
songs = []
|
|
offset = 0
|
|
limit = 50
|
|
|
|
while True:
|
|
headers = {"Authorization": f"Bearer {access_token}"}
|
|
params = {"limit": limit, "offset": offset}
|
|
resp = requests.get(
|
|
f"https://api.spotify.com/v1/albums/{album_id}/tracks", headers=headers, params=params).json()
|
|
offset += limit
|
|
songs.extend(resp["items"])
|
|
|
|
if len(resp["items"]) < limit:
|
|
break
|
|
|
|
return songs
|
|
|
|
|
|
def get_album_name(access_token, album_id):
|
|
""" Returns album name """
|
|
headers = {"Authorization": f"Bearer {access_token}"}
|
|
resp = requests.get(
|
|
f"https://api.spotify.com/v1/albums/{album_id}", headers=headers).json()
|
|
return resp["artists"][0]["name"], sanitize_data(resp["name"])
|
|
|
|
# Extra functions directly related to spotify artists
|
|
|
|
|
|
def get_artist_albums(access_token, artist_id):
|
|
""" Returns artist's albums """
|
|
headers = {"Authorization": f"Bearer {access_token}"}
|
|
resp = requests.get(
|
|
f"https://api.spotify.com/v1/artists/{artist_id}/albums", headers=headers).json()
|
|
# Return a list each album's id
|
|
return [resp["items"][i]["id"] for i in range(len(resp["items"]))]
|
|
|
|
# Extra functions directly related to our saved tracks
|
|
|
|
|
|
def get_saved_tracks(access_token):
|
|
""" Returns user's saved tracks """
|
|
songs = []
|
|
offset = 0
|
|
limit = 50
|
|
|
|
while True:
|
|
headers = {"Authorization": f"Bearer {access_token}"}
|
|
params = {"limit": limit, "offset": offset}
|
|
resp = requests.get("https://api.spotify.com/v1/me/tracks",
|
|
headers=headers, params=params).json()
|
|
offset += limit
|
|
songs.extend(resp["items"])
|
|
|
|
if len(resp["items"]) < limit:
|
|
break
|
|
|
|
return songs
|
|
|
|
|
|
# Functions directly related to downloading stuff
|
|
def download_track(track_id_str: str, extra_paths="", prefix=False, prefix_value="", disable_progressbar=False): # pylint: disable=too-many-locals,too-many-branches
|
|
""" Downloads raw song audio from Spotify """
|
|
try:
|
|
artists, album_name, name, image_url, release_year, disc_number, track_number, scraped_song_id, is_playable = get_song_info(
|
|
track_id_str)
|
|
|
|
song_name = artists[0] + " - " + name
|
|
if prefix:
|
|
song_name = f"{prefix_value.zfill(2)} - {song_name}" if prefix_value.isdigit(
|
|
) else f"{prefix_value} - {song_name}"
|
|
|
|
if ZS_CONFIG["SPLIT_ALBUM_DISCS"]:
|
|
filename = os.path.join(ZS_CONFIG["ROOT_PATH"], extra_paths, "Disc " + str(
|
|
disc_number) + "/" + song_name + "." + ZS_CONFIG["MUSIC_FORMAT"])
|
|
else:
|
|
filename = os.path.join(ZS_CONFIG["ROOT_PATH"], extra_paths,
|
|
song_name + "." + ZS_CONFIG["MUSIC_FORMAT"])
|
|
except Exception as err: # pylint: disable=broad-except,unused-variable
|
|
print("### SKIPPING SONG - FAILED TO QUERY METADATA ###")
|
|
# print(err)
|
|
else:
|
|
try:
|
|
if not is_playable:
|
|
print("### SKIPPING:", song_name,
|
|
"(SONG IS UNAVAILABLE) ###")
|
|
else:
|
|
if os.path.isfile(filename) and os.path.getsize(filename) and ZS_CONFIG["SKIP_EXISTING_FILES"]:
|
|
print("### SKIPPING:", song_name,
|
|
"(SONG ALREADY EXISTS) ###")
|
|
else:
|
|
if track_id_str != scraped_song_id:
|
|
track_id_str = scraped_song_id
|
|
|
|
track_id = TrackId.from_base62(track_id_str)
|
|
# print("### FOUND SONG:", song_name, " ###")
|
|
|
|
stream = SESSION.content_feeder().load(
|
|
track_id, VorbisOnlyAudioQuality(QUALITY), False, None)
|
|
# print("### DOWNLOADING RAW AUDIO ###")
|
|
|
|
if ZS_CONFIG["SPLIT_ALBUM_DISCS"]:
|
|
os.makedirs(
|
|
ZS_CONFIG["ROOT_PATH"] + extra_paths + "/Disc " + str(disc_number) + "/", exist_ok=True)
|
|
else:
|
|
os.makedirs(ZS_CONFIG["ROOT_PATH"] +
|
|
extra_paths, exist_ok=True)
|
|
|
|
total_size = stream.input_stream.size
|
|
with open(filename, "wb") as file, tqdm(
|
|
desc=song_name,
|
|
total=total_size,
|
|
unit="B",
|
|
unit_scale=True,
|
|
unit_divisor=1024,
|
|
disable=disable_progressbar
|
|
) as p_bar:
|
|
for _ in range(int(total_size / ZS_CONFIG["CHUNK_SIZE"]) + 1):
|
|
p_bar.update(file.write(
|
|
stream.input_stream.stream().read(ZS_CONFIG["CHUNK_SIZE"])))
|
|
|
|
if not ZS_CONFIG["RAW_AUDIO_AS_IS"]:
|
|
convert_audio_format(filename)
|
|
set_audio_tags(filename, artists, name, album_name,
|
|
release_year, disc_number, track_number)
|
|
set_music_thumbnail(filename, image_url)
|
|
|
|
if not ZS_CONFIG["OVERRIDE_AUTO_WAIT"]:
|
|
time.sleep(ZS_CONFIG["ANTI_BAN_WAIT_TIME"])
|
|
except Exception: # pylint: disable=broad-except
|
|
print("### SKIPPING:", song_name,
|
|
"(GENERAL DOWNLOAD ERROR) ###")
|
|
if os.path.exists(filename):
|
|
os.remove(filename)
|
|
|
|
|
|
def download_album(album):
|
|
""" Downloads songs from an album """
|
|
token = SESSION.tokens().get("user-read-email")
|
|
artist, album_name = get_album_name(token, album)
|
|
tracks = get_album_tracks(token, album)
|
|
for num, track in tqdm(enumerate(tracks, start=1), unit_scale=True, unit="Song", total=len(tracks)):
|
|
download_track(track["id"], f"{artist}/{album_name}",
|
|
prefix=True, prefix_value=str(num), disable_progressbar=True)
|
|
|
|
|
|
def download_artist_albums(artist):
|
|
""" Downloads albums of an artist """
|
|
token = SESSION.tokens().get("user-read-email")
|
|
albums = get_artist_albums(token, artist)
|
|
for album_id in albums:
|
|
download_album(album_id)
|
|
|
|
|
|
def download_playlist(playlists, playlist_choice):
|
|
"""Downloads all the songs from a playlist"""
|
|
token = SESSION.tokens().get("user-read-email")
|
|
|
|
playlist_songs = get_playlist_songs(
|
|
token, playlists[int(playlist_choice) - 1]["id"])
|
|
|
|
for song in playlist_songs:
|
|
if song["track"]["id"] is not None:
|
|
download_track(song["track"]["id"], sanitize_data(
|
|
playlists[int(playlist_choice) - 1]["name"].strip()) + "/")
|
|
print("\n")
|
|
|
|
|
|
def download_from_user_playlist():
|
|
""" Select which playlist(s) to download """
|
|
token = SESSION.tokens().get("user-read-email")
|
|
playlists = get_all_playlists(token)
|
|
|
|
count = 1
|
|
for playlist in playlists:
|
|
print(str(count) + ": " + playlist["name"].strip())
|
|
count += 1
|
|
|
|
print("\n> SELECT A PLAYLIST BY ID")
|
|
print("> SELECT A RANGE BY ADDING A DASH BETWEEN BOTH ID's")
|
|
print("> For example, typing 10 to get one playlist or 10-20 to get\nevery playlist from 10-20 (inclusive)\n")
|
|
|
|
playlist_choices = input("ID(s): ").split("-")
|
|
|
|
if len(playlist_choices) == 1:
|
|
download_playlist(playlists, playlist_choices[0])
|
|
else:
|
|
start = int(playlist_choices[0])
|
|
end = int(playlist_choices[1]) + 1
|
|
|
|
print(f"Downloading from {start} to {end}...")
|
|
|
|
for playlist in range(start, end):
|
|
download_playlist(playlists, playlist)
|
|
|
|
print("\n**All playlists have been downloaded**\n")
|
|
|
|
|
|
# Core functions here
|
|
|
|
|
|
def check_raw(): # pylint: disable=missing-function-docstring
|
|
if ZS_CONFIG["RAW_AUDIO_AS_IS"]:
|
|
ZS_CONFIG["MUSIC_FORMAT"] = "wav"
|
|
|
|
|
|
def main():
|
|
""" Main function """
|
|
check_raw()
|
|
login()
|
|
client()
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|