Hailin's Weblog

June 5, 2009

Captions and subtitles for WordPress.tv

Filed under: social — Hailin @ 8:15 am

WordPress.tv is a popular blog hosting collections of WordPress videos, including WordCamp videos, tutorials, etc. It’s the visual resource for all things WordPress.

WordPress.tv has just integrated with dotSUB to provide translation for some popular videos.  To help translate your most favorite videos into your language, you can create a dotSUB account, then visit WordPress tv project to begin translation.

Technical details on how the integration works:

Once a new video is added to the dotSUB WordPress tv project, all the translation is done by volunteers  using dotSUB toolsets.  dotSUB then provides an external public API to access its translation metadata and translation texts.

The API  has the following form:

where dotsub_username is username one created for your video project at dotSUB, and dotsub_external_reference has to be the guid of the corresponding WordPress.com video.

For example, the public APIs for a WordPress.tv video “Adding categories and tags to your posts” ( guid 1UKXOM9q) are:

WordPress.com video player queries the above API URLs and integrates the translation texts. 
Watch this particular video clip below:

Configuring dotSUB external reference

In order for the video player to locate the correct API URL, the external reference has to be configured correctly as the guid  of each video.

It takes the following steps:

Step 1.
Select  your video within dotSUB project space. Click “Video Properties” tab, then Click “Edit Video”.

View the screenshot

Step 2.
Find out the guid of this same video within WordPress.com blog media library. The guid is the portion of the shortcode without brackets. Eg: if the shortcode is [wpvideo 1UKXOM9q], then the guid is 1UKXOM9q
Enter the guid into text field “External reference”, then click Save. All the other fields such as video title, year of publication are for dotSUB internal use, thus not required for the integration to work.

View the screenshot

Step 3.
The change will take effect in about 12 hours because the internal video information is cached for 12 hours.  To force it to take effect immediately, clear the cache, then check the video info again. Eg:


 (of course replace the guid with your specific ones).

 If you see <dotsub_metadata> and <dotsub_caption>, that means cache is cleared, your dotSUB configuration has been applied successfully, and the translation will be displayed by WordPress.com video player.


  1. Looks wonderful, nice work!

    Comment by Peder — June 15, 2009 @ 8:35 am

  2. Peder,
    Thanks a lot for your help throughout the integration process! Much appreciated!

    Comment by Hailin — June 15, 2009 @ 9:23 am

  3. hhmm .. wordpress, I use blogger. But someday I’ll be using wordpress. thanks..

    Comment by mind author — September 11, 2009 @ 9:47 pm

  4. Captions and subtitles for WordPress.tv « Hailin’s Weblog…

    Trackback by untell.com — December 6, 2009 @ 12:17 am

  5. You’ve done it once again. Incredible writing.

    Comment by Dorthy Gill — May 31, 2010 @ 7:48 am

RSS feed for comments on this post. TrackBack URI

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

Blog at WordPress.com.

%d bloggers like this: