CCaptioner

A very simple extension which purpose is to assign a text track (.srt or .vtt) to a HTML5 video element in a web page.

Many HTML5 video players do not offer the ability to import text track for captions/subtitles purpose. The purpose of this extension is to remediate this problem.

When you want to assign a text track to a video element in a web page:

- Open the popup menu and click "Assign text track to..."
- Move the mouse over the target video element
- Click the video element if needed
- A file picker will appear
- Pick the .srt or .vtt file to use as text track

The video should now render the captions/subtitles of the file you selected.

The content scripts of CCaptioner are injected if and only if you click on its toolbar icon while on a specific web site, and only for that web site. Once the text track is embedded, the content script terminates and should be garbage-collected by your browser's JavaScript engine.

Once a text track has been assigned to a video element on a given page, you can time-shift the text track through CCaptioner's popup panel -- this is useful when the text track is not well synchronized with the video content.

## Permissions

### activeTab

This permission means that the extension will be able to interact with a web page only when you click its icon in the toolbar; so CCaptioner's content script is injected only when you demand it by clicking CCaptioner's toolbar icon.

### <all_urls>

This permission is necessary to ensure CCaptioner's content script can also be injected in embedded iframe elements in a page -- it is not uncommon for video players to be inside an iframe which origin is different from the origin of the root document.