Live From The Fort

A VPR music video series, similar to NPR's Tiny Desk Concerts

Releasing Updates

The steps to get set up locally and release new versions when the spreadsheet is updated. These are commands that should be run from the command line.

1. Clone the repository locally - git@github.com:vprnet/live-from-the-fort.git
2. Ensure you have Python 2.7 installed
3. Install pip
4. Install virtualenv - pip install virtualenv
5. Change into the project directory - cd live-from-the-fort
6. Create a virtual environment for the app - virtualenv venv
7. Enter the virtual environment - source venv/bin/activate
8. Install the app requirements - pip install -r requirements.txt
9. Copy the config file - cp app/_config.py app/config.py
10. Configure the values in app/config.py
11. Upload the app to AWS S3 - python app/index.py build

To Run Locally

Remove 'build' argument from last step, so: python app/index.py

Notes on Interacting with Google Spreadsheets

In May 2015, Google stopped supporting the Google Spreadsheets API, which Live From the Fort used to connect a spreadsheet to the page. We found a good replacement in gspread. Here are a few things to know about our new implementation:

1. To start a new project, head to the Google Developer's Console.
2. Click create project.
3. Under APIs, enable the Google Drive API.
4. In Credentials under OAuth, create a new Client ID.
5. Select Service Account. You'll see a json file incoming with a private_key_id, private_key, client_email, client_id, and type.
6. Save the json file in your project. Be a good person and add it to your gitignore, too.
7. The json file is what gets loaded and opened in sheet.py. Make sure the names match!
8. Finally, share your google spreadsheet with the email provided in client_email.
9. You'll also need to pip install gspread and pip install oauth2client.

FOR VUHAUS:

1. Replace old YouTube links with the URL of the video that you can get from the embed code that YouTube provides.
2. VuHaus video should be the URL from the embed code that VuHaus provides.

##Copyright and License

Copyright 2013 Vermont Public Radio

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions under the License.