#NowRadio

NowRadio is an internet radio music player. It allows users to easily navigate between different stations and different genres so they can find something they like.

##SETUP

Tested on Ubuntu 14.04 x64

sudo apt-get update

Install necessary packages

sudo apt-get install -y \
    postgresql-9.3 postgresql-server-dev-9.3 \
    git \
    python-psycopg2 python-dev python-pip \
    build-essential libxml2-dev libxslt-dev

Go to the directory where you want NowRadio to be installed

git clone https://github.com/karlwithak/nowradio.git

cd nowradio

Optional: Set up virtualenv.

pip install virtualenv
virtualenv venv
source venv/bin/activate

Now, Python packages will be installed in a virtual environment and not conflict with other packages on your system. However, you will have to run source venv/bin/activate whenever you run the app.

Install necessary python packages.

pip install -r python_requirements.txt

Login as postgres user

sudo su postgres

Create new database user

createuser -dP nowradio_user

Enter password: nowradio_pass or whatever you have in serverInfo.py

Create database;

createdb --owner=nowradio_user nowradio_db

Fill up database;

psql nowradio_db < db/station_info_dump.sql

Exit postgres user;

exit

Note that serverInfo.py is never checked in and may contain secret info. If you want to use a different password for the database user, it must also be changed here.

cp nowradio/serverInfo.template.py nowradio/serverInfo.py

Start NowRadio!

./start-dev

You should now be able to view the running app at localhost:5000 or if installed on a server will be running at [server ip]:5000

##CONTRIBUTING

Contributions are always welcome.

Please submit changes for review by [forking and sending a pull request from your topic branch] (https://help.github.com/articles/using-pull-requests). Feel free to submit pull requests for any existing issue that has not already been assigned to someone else. If you want to add a major new feature or improvement that does not have an existing issue please create a new issue explaining it before creating a PR or spending much time working on it. By creating an issue, it gives us a way to discuss the potential change.