Initial Setup

One-time post-install tasks for TubePress Pro

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.

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.

WP Admin TubePress options page

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.

    Enter Google API key

  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.

    Create new Vimeo app

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

    Vimeo app registration

    • 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.

    App Callback URLs location

    • 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.

    Properly filled-out form

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

    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.

    Client ID and secret entry

  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.

    New token button

    A popup window will briefly open, then close itself.

    Brief popup window

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

    Success modal

    And you should also see a new API token.

    New token verification

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

    Save button

Edit on GitHub