spotish 1.2.5

Description:

spotish 1.2.5

spotish
download tracks and playlists on spotify;
install
install spotish with pip:
pip install spotish

usage
to use spotish, you need to create a spotify application:


go to https://developer.spotify.com/dashboard/applications and log in;


click create a client id;


fill in any name and description, then choose desktop app;


on next page, when asked are you developing a commercial integration?,
choose no;


on next page, tick all boxes and click submit;


now the app is created; the app page lists its client id and client secret,
which will be used when you run spotish; we also need a redirect uri, so
click edit settings;


add http://localhost/callback/ in redirect uris; this uri will be used
when you run spotish;


click save;


now we have a spotify username, a client id, a client secret and a redirect uri;
download tracks
to download saved tracks into the default out dir:
spotish --user {username} \
--client-id {client_id} --client-secret {client_secret} \
--redirect-uri {redirect_uri} \
tracks

on first run, this will open a web browser and ask you to enter the redirect uri
to authenticate; simply follow the instructions; this will generate a hidden
cache file named .cache-{username} in current dir, containing spotify web api
access token; later runs of spotish dont need authentication until the access
token expires;
tracks are organized by their albums; both albums and tracks are named after
their uuids; an album uuid contains total tracks in album, album uri and album
name; a track uuid contains track number within the album, track uri and track
name; album and track uris already guarantee uniqueness; however, uuids contain
more information and are easier to visualize; by using uuids, tracks within an
album are automatically sorted by their track numbers, which looks very nice;
to download saved tracks with more complete metadata and helpful progress text:
spotish --user {username} \
--client-id {client_id} --client-secret {client_secret} \
--redirect-uri {redirect_uri} \
--output {dir} \
--album-image --track-preview \
--verbose \
tracks

download playlists
to download saved playlists, use command playlists instead of tracks:
spotish --user {username} \
--client-id {client_id} --client-secret {client_secret} \
--redirect-uri {redirect_uri} \
--output {dir} \
--playlist-image --track-preview \
--verbose \
playlists

tracks are organized by their playlists, not albums; both playlists and tracks
are named after their uuids; a playlist uuid contains playlist index, playlist
uri and playlist name; a track uuid contains track index within the playlist,
track uri and track name;
depend
spotish depends on:

spotipy;

license
Copyright (c) 2012-2018 Cyker Way
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.