Apollo Player

Opensource community driven playlist using Spotify, Mopidy, Node.js and Backbone.js

Features

Simple and elegant group playlist
Song Bombs = 3 unique votes skips the track and "boos" the player
Search keywords or Spotify URI's
Play / Pause toggle
Default Playlist (plays when Apollo runs out of songs to play)

Get Started

Prerequisites

Don't talk about Fight Club.
You'll need to have a basic understanding of Node and Node's package manager. I'll add that I didn't have a basic understanding of Node at all before this project and used Apollo to help me learn it... So there's hope for you too!

Install and configure Mopidy

First we'll need to install Mopidy. Mopidy is a opensource music server that you can connect to many "frontends" or roll your own, which what Apollo is. To read more about Mopidy go here.

Install Mopidy. Mopidy is an opensource music server that installable on OSX, Debian/Ubuntu, Rasberry Pi. *note: so far we've only tested on Debian and OSX.
1. You'll need to do the Spotify installation
2. Next you'll need to enable http on Mopidy
Start Mopidy on the commandline (if this doesn't work check the mopidy docs, probably a python path issue.)
```
$ mopidy
```
Optional: You'll want to have Mopidy running in the background at all times for Apollo to work. You'll want to look into making Mopidy a Daemon so that if it crashes it will auto-restart.

Install Apollo

Now that you have Mopidy up and running, let's setup up Apollo as our Frontend for it.

Clone Apollo to a local folder

$ git clone https://github.com/samcreate/Apollo-Player.git

$ cd Apollo-Player

Install Node dependencies
```
$ npm install
```
Configure Apollo
1. Create a file called config.js in root directory of Apollo
```
$ touch config.js (or just create it with an editor)
```
1. add this structure into config.js file:
```
var config = {
  development: {
    server: {
      host: "localhost",
      port: 3000,
    },
    "twitter_callback":"http://localhost:3000/auth/twitter/callback",
    "consumerKey":"YOUR TWITTER CONSUMER KEY",
    "consumerSecret":"YOUR TWITTER SECRET",
    "default_playlist_uri":"SPOTIFY URI TO DEFAULT PLAY LIST (cannot be private!)",
    "htmlPretty": "true"
  }
};

module.exports = config[process.env.NODE_ENV || 'development'];
```
2. Setup a Twitter app and fill in the twitter consumer key and consumer secret. (required)
  1. After you've created an app, you'll need to make sure you have these details filled in for authentication to work.
  2. Application details (Even though your localhost is going to be running on port 3000, just fill in these details exactly to make work)
    1. Name: can be whatever you want (required)
    2. Description: can be whatever you want (required)
    3. Website: http://localhost.com (required)
    4. Callback URL: http://localhost.com/auth/twitter/callback (required)
    5. Allow this application to be used to Sign in with Twitter: leave unchecked.
3. Add your Spotify default playlist uri (this has to be a public playlist to work). This is what plays when all the songs in the queue have finished playing (required)
Start Apollo
```
$ node apollo.js
```

Once Apollo is started, navigate to your localhost: http://localhost:3000

Finished!

Notes

If you change a value in config.js, you'll need to restart node (ctrl+c)
Apollo works best in Chrome.

Tech used

Frontend: Backbone, RequireJS, Bootstrap, Handelbars, Jade templating and stylus
Backend: Node.js, ExpressJS

willieavendano / Apollo-Player