README.md

What is this repo?

Sortify is a Python app built with the Flask framework. It uses the Spotipy API to allow you to view and sort your Spotify playlists to your heart's content. I hosted the app on Heroku.

I decided to make this app to build my web-app skills, this is my first ever web-app and I'm quite proud of it.

Features supported:

• Supported sorting options:
  • Alphabetically (A-Z)
  • Alphabetically (Z-A)
  • Release Date (Chronological)
  • Release Date (Non Chronological)
  • Date Added
• View playlist tracks in a table
• Heroku deploy ready
• Can sort unlimited number of tracks
• Maintains the date added upon sorting (only if the playlist has under 100 tracks)

To do list:

• Add support to sort playlists of more than 100 tracks
• Maintain 'added_at' date after sorting
• Add support to sort other people's playlists
• Add option to sort playlist into new playlist

Installation

Prerequisites:

• A server, could be your own computer or Heroku; this repository is Heroku ready
• Python 3.8 or above
• A Spotify app

Part 1 (Spotify API):

• First you need to setup a Spotify API app. To do this go to the Spotify Developer's Dashboard
• Create an app
• Name the app anything and describe it as anything. But set it as a Website
• On the app's page click Edit Settings and under Redirect URIs add this: http://127.0.0.1:5000/callback
• If your app is not locally hosted than make the Redirect URI something like this https://yourwebsite.com/callback
• Finally exit back onto the main app's page and copy down the Client ID and Client Secret, you will need these in the next step

Part 2 (The App):

• Now it's time to make the app. First clone this repository in a command line using git clone https://github.com/eliasbenb/Sortify.git
• CD into the directory with cd Sortify
• Open app.py with a text editor and change the following variables:
  • app.secret_key to any string e.g. "string123"
  • SPOTIFY_CLIENT_ID to the Client ID you got from Step 1
  • SPOTIFY_CLIENT_SECRET to the Client Secret you got from Step 1
  • REDIRECT_URI to whatever you set your Redirect URI to in Step 1
• If you are setting this up for a public website like I am I would recommend using Environment Variables to set the above variables
• Now your app is ready to be used, to start the app just enter this in a command line flask run

Usage:

Home Page:

• The home page contains Sortify information
• And it contains a 'Login' button, clicking it will lead to the Spotify authentication page

Login Page:

• After successfully authenticating your Spotify account, you will receive a success message

Playlists Page:

• After scrolling down on the playlists page you will see all your playlists's images, clicking one will open that playlist's page

Playlist Page:

• The playlist page contains a table which displays all the playlist's tracks and its information
• Below that there are a group of buttons which allow you to sort the playlist:
  • Alphabetically (A-Z)
  • Alphabetically (Z-A)
  • Release Date (Chronological)
  • Release Date (Non Chronological)
  • Added Date