Initial Setup

You've downloaded and installed TubePress to your website - great! If this is your first time using TubePress, you'll need to perform some initial configuration before you go further. These are one-time jobs that should take just a few minutes.

Navigate to the TubePress options page

First, you'll want to find the TubePress options page within your WordPress admin dashboard. This page is located at WP Admin > Settings > TubePress. Go ahead and navigate there now before moving on.

About Provider APIs

TubePress needs to regularly communicate with video providers (YouTube, Vimeo, etc.) on your behalf. To sort out all the incoming requests, and for quota purposes, these providers mandate that everyone supplies "API credentials" with each message. It's the rough equivalent of showing someone an ID card before you have a conversation.

Setting up your API credentials is easy, free, and should take less than 5 minutes per provider. You only need to complete this step for providers that you actually use. (In other words, if you aren't using Vimeo, you can safely skip the Vimeo API setup.)

YouTube API Setup

1. Follow these instructions to obtain a new API key for YouTube.

2. On the TubePress options page, click the "Feed" tab.

3. Enter your API key into the text field for "Google API Key", as shown below.

   

4. Click "Save" to save your settings. That's it!

Vimeo API Setup

1. You'll need a Vimeo account. If you don't have one, you can sign up for one for free.
   

2. In the "Feed" tab of the TubePress options page, scroll down to the Vimeo area. Click the link that says "Click here to create a new Vimeo app". This will open a new tab in your web browser on vimeo.com.

   
   

3. In the new web browser tab, you'll see a form from Vimeo.

   

   • Enter anything you'd like for the App Name, App Description, and App URL.
     
   • Important. For the "App Callback URLs" field, you will need to enter the exact value shown to you back on the TubePress options page. We recommend copying it to your clipboard and pasting it into the Vimeo form.

   

   • Check the box to accept Vimeo's license and terms, then click the "Create app" button.

   Here's an example of a form that's been properly filled out.

   
   

4. After your new Vimeo app has been created, click the "Authentication" tab. You'll see your app's "Client Identifier" and "Client Secrets"

   

   !!! note The "Authentication" tab may be named "OAuth2"

5. Enter those two values into the text fields on the TubePress options page.

   
   

6. Click the "Save" button to save your settings once. (We are working to eliminate this intermediary step, but for now it's necessary.)

7. Click the "New token" button.

   

   A popup window will briefly open, then close itself.

   

   After the popup closes, you should see a success message.

   

   And you should also see a new API token.

   

8. Click the Save button to save your settings. You're done!