Mapping sounds across Edinburgh and the UK.
Python JavaScript CSS Shell
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
static
templates
.gitignore
LICENSE
Procfile
README.md
models.py
redis.sh
requirements.txt
server.py

README.md

socialsoundsproject-map

The Social Sounds Project map shows sounds uploaded to Social Sounds Projects across the UK, and allows anyone to upload a sound and mark it on the map.

The Social Sounds Project webapp is currently served by a single Heroku dyno, and uses a Redis Cloud addon to store authentication credentials across sessions.

Sound data and metadata is stored on the Social Sounds Project SoundCloud page.

Usage

Requirements

Environment Variables

The following environment variables need to be set for the server to run correctly:

export SECRET_KEY=''                     # random secret string - feel free to mash the keyboard for this
export SOUNDCLOUD_AUTH_PATH=''           # secret address on server to authenticate your SoundCloud account
export SOUNDCLOUD_CLIENT_SECRET=''       # SoundCloud API Secret
export SOUNDCLOUD_CLIENT_ID=''           # SoundCloud API ID
export REDISCLOUD_URL='redis://…'         # Redis Cloud server address

export ADMIN_EMAIL='incase@thingsbreak.net'

# SMTP variables in order to email notification of breakages to $ADMIN_EMAIL
export SMTP_HOST=''
export SMTP_PORT='25'
export SMTP_USERNAME=''
export SMTP_PASSWORD=''

If developing locally, it's recommended that you put these variables into a .env file and use autoenv to load them upon entering the project directory.

Setup

git clone https://github.com/jeffbr13/socialsoundsproject-map
cd socialsoundsproject-map
mkvirtualenv -a . -r requirements.txt socialsoundsproject-map

Run the server

python server.py

To authenticate your server with your SoundCloud account, visit http://{server-address}/{SOUNDCLOUD_AUTH_PATH}, with SOUNDCLOUD_AUTH_PATH being a string stored in an environment variable.

License

Source code in this repository is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.