binb is a simple, realtime, multiplayer, competitive music listening game.

Installation

Unless previously installed you'll need the following packages:

Please use their sites to get detailed installation instructions.

The first step is to install the dependencies:

npm install

Then you need to minify the assets:

npm run minify

Now make sure that the Redis server is running and load some sample tracks:

npm run import-data

Finally run npm start or node app.js to start the app.

Point your browser to http://127.0.0.1:8138 and have fun!

Some package managers name the Node.js binary nodejs. In this case you'll get the following error:

sh: node: command not found

To fix this issue, you can create a symbolic link:

sudo ln -s /usr/bin/nodejs /usr/bin/node

and try again.

Browser compatibiliy

binb requires a browser that supports the WebSocket protocol.

Refer to this table for details on compatibility.

Have a bug? Please create an issue here on GitHub, with a description of the problem, how to reproduce it and in what browser it occurred.

binb is released under the MIT license. See LICENSE for details.