Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/stve/watch-later-api

YouTube Watch Later playlist Workflow integration
https://github.com/stve/watch-later-api

Last synced: 23 days ago
JSON representation

YouTube Watch Later playlist Workflow integration

Host: GitHub
URL: https://github.com/stve/watch-later-api
Owner: stve
License: mit
Created: 2016-05-31T14:57:39.000Z (over 8 years ago)
Default Branch: main
Last Pushed: 2023-01-20T22:14:13.000Z (almost 2 years ago)
Last Synced: 2024-04-14T14:15:39.149Z (7 months ago)
Language: Ruby
Size: 803 KB
Stars: 16
Watchers: 2
Forks: 1
Open Issues: 8
Metadata Files:
- Readme: README.md
- License: LICENSE.md

Awesome Lists containing this project

README

# Watch Later

Easily add YouTube videos to your Watch Later playlist from [Workflow](http://workflow.is)

## Configuration

### Setup on Google API access

1. Login to the [Google Developer Console](https://console.developers.google.com/apis/library) and create a new project
2. Enable the following APIs:
* [YouTube Data API v3](https://console.developers.google.com/apis/api/youtube/overview)
* [Google+ API](https://console.developers.google.com/apis/api/plus/overview)
* [Contacts API](https://console.developers.google.com/apis/api/contacts/overview)

3. Create new credentials for your application (Follow the [yt gem's instructions](http://www.rubydoc.info/gems/yt#Configuring_your_app), you'll want to create an application that requires user interactions)
4. Store the client id and secret for deployment

### Deployment

The server requires 4 environment variables:

* `YT_CLIENT_ID` - Taken from step 4 above
* `YT_CLIENT_SECRET` - Also taken from step 4 above
* `RACK_COOKIE_SECRET` - A key you should keep secret
* `REDISTOGO_URL` - A URL to a redis server

#### Setup on Heroku

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)

The application is a Sinatra app that can run on the [Heroku Buildpack for Ruby](https://github.com/heroku/heroku-buildpack-ruby). Clone the repository and push to heroku (or use the deploy button above) to create your instance. Once launched, be sure to configure your environment variables. You'll also need to add the Redis To Go add-on.

Once running, you can visit `https:///auth/google_oauth2` to authorize your YouTube account. Then add the workflow below and you are ready to roll.

### Setup on Workflow

Add the [workflow](https://cdn.rawgit.com/stve/watch-later/master/workflow/Add%20to%20YouTube%20Watch%20Later%20playlist.wflow) to your Workflow iOS app. At minimum, you'll want to adjust the `rootUrl` variable to point it to your web service location. The workflow is designed to run as an Action Extension. Typically I use it by sharing a YouTube URL (or shortlink) and invoking the Workflow from the share menu in iOS. Refer to the [usage documentation](docs/README.md) for a more detailed explanation of how to use it.