README.md

dmhacker-youtube

This contains a gateway for my alexa-youtube-skill as well as a web-based, Youtube-specific proxy.

Prerequisites

Before setting up anything, follow this blog post to obtain a YouTube API key. It will come in use later.

Automatic Setup Process (recommended)

Manual Setup Process

1. Fork this repository. Make sure your branch is up-to-date with master.
2. Now, go to https://heroku.com and create an account (or log in, if you already have an account).
3. On your dashboard, click on "New" -> "Create new app"
4. Give your app a name (referred to as {YOUR_APP_NAME}) and select a region for deployment.
5. Go to the Deploy section on your new app's dashboard.
   1. Under Deployment Method, select the GitHub option. You should be prompted to authorize Heroku's usage of your GitHub account information.
   2. Under Connect to GitHub, make sure your account is selected and type in "dmhacker-youtube" for the repository to search for.
   3. If you correctly forked this repository and typed in the repository name correctly, this should show up as an option to connect to. Click on "Connect".
6. Now, go to the Settings section on your app's dashboard.

   1. Under Config Variables, click on "Reveal Config Vars" and then enter in the following key-value pair(s):

      Key	Value
      YOUTUBE_API_KEY	the YouTube API key you generated earlier

   2. Next, under Buildpacks, click on "Add buildpack" and click on the icon named "nodejs".

7. Now, you're ready to deploy! Go back to the Deploy section.
   1. Under Manual Deploy, click on "Deploy Branch".
8. If you get a "Your app was successfully deployed", congratulations, you are done, and your app should be running!
9. To verify, open up https://{YOUR_APP_NAME}.herokuapp.com in a new tab and see if it returns a correctly formed landing page.