Skip to content

musicvote/ListenUp

Repository files navigation

ListenUp

Listen Up is a mobile optimized web application that allows users to connect playlists created in Spotify in an effort to crowd source those playlist creating responsibilities. Any party host, DJ, road-trip organizer or anyone else with a Spotify account, may connect a Spotify playlist by plugging in their shareable Spotify playlist URL into ListenUp. By giving us that Spotify playlist URL, we instantiate the instantaneous connection between your Spotify playlist and your ListenUp playlist. By creating a ListenUp playlist, you allow participants to:

  • Search for songs via Spotify's search API
  • Add songs to that newly created playlist
  • Vote on songs that are in the playlist As participants add songs and cast votes on songs, the queue of songs from Listen Up will flow into Spotify and play the songs in the order of votes in descending order.

Due to ListenUp's relliance on a Spotify developer authentication token which expires every 60 minutes, this application is in progress. The app can be run once an active token is inputted into the code.

Setup

To use this web application, you'll need to take the following steps:

  • git clone this repo

  • Run the following commands:

  • npm install

  • npm run start-dev

Customize

Now that you've got the code, follow these steps to get acclimated:

  • Create a file called secrets.js in the project root

    • This file is .gitignore'd, and will only be required in your development environment
    • Its purpose is to attach the secret env variables that you'll use while developing
    • However, it's very important that you not push it to Github! Otherwise, prying eyes will find your secret API keys!
    • It might look like this
      process.env.SPOTIFY_CLIENT_ID = 'hush hush'
      process.env.SPOTIFY_CLIENT_SECRET = 'pretty secret'
      process.env.SPOTIFY_CALLBACK = '/auth/spotify/callback'
    
  • To use OAuth with Spotify, complete the step above with a real client ID and client secret obtained from Spotify.

Start

npm run start-dev will make great things happen!

If you want to run the server and/or webpack separately, you can also npm run start-server and npm run build-client.

From there, just follow your bliss.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published