Artist Expander

This little tool creates a playlist of the most popular songs from artists in a user's Spotify library for which they have only 1 song saved. The goal is to make it easy to find more good music by artists they've already shown interest in, but haven't fully explored yet.

Usage

For now, you can only use this by running it on your own machine. You will need Python 2.7, the pip package manager, and git. Virtualenvs will also help.

1. Clone the project.
   $ git clone git@github.com:jzimbel/artist-expander.git
2. Set options if you like, by opening and editing config.py in the cloned directory. See info on options further down in this README.
3. Make a virtualenv for the project. (Optional)
   $ mkvirtualenv artist-expander
4. Go to the directory of the cloned project, and install dependencies.
   $ cd artist-expander
$ pip install -r requirements.txt
5. Now you need to grab some info about your Spotify account. Open Spotify and click on your name at the top right. Click the "..." menu under your name in the page that loads, and select "Copy Profile Link". Paste this somewhere, like a message window or a text file, and copy the part after the last /. If you signed up through Facebook, this is just a number.
   https://open.spotify.com/user/128300609
____________________this part ^^^^^^^^^
6. Run the project. In the same terminal session where you did step 4, run:
   $ ./local_launch.sh
   Enter the user ID you copied when prompted.
7. A browser tab will open up and Spotify will check if you're okay with giving the program some permissions for your account. If you are, click 'Okay'.
8. You'll get redirected to Google, but if you look at your browser's URL bar, you'll see a huge code after '.com'. Copy the WHOLE link, as in, 'select all'+'copy', and paste this into the same terminal session where you did step 6.
9. You're done! Phew. The program will take 30 seconds to a minute to build your playlist. Wait another 2 or so minutes after it's done for the playlist to show up in Spotify.

Options

There are a few options you can set at the bottom of the file config.py before running.

Name	Type	Effect
TRACKS_PER_ARTIST	Integer	Set number of tracks per artist to add to the playlist.
COLLATE	Boolean	Set this to True to mix tracks by different artists. Full description in config.py.
PUBLIC	Boolean	Set this to True to make your generated playlist public.

---

I made this during the HackBeanpot 2017 hackathon: https://hackbeanpot.com/