OpenedCaptions

A distributed API for live TV closed captions.

This package can be easily incorproated into any node project in order to write code that knows what is happening on live television.

Please be warned that the project is early in its development, which means the API and code base are generally unstable for the short term.

Initially, this package is intended to power front-end applications, but eventually it will support server side events as well

New in 1.0

Opened Captions used to be a standalone node app; you could download it and run it, which was fine for a quick hack but didn't make it particularly easy to use in your own code base. Now Opened Captions is an NPM package. See below for the new installation instructions. You can also use the example server to get started.

The architecture has been redone to make it easy to create new stream types. Payloads also include information about the stream itself, thus supporting multiple channels from a single server.

Installing Opened Captions

npm install opened-captions

Creating an Opened Captions Stream

Creating an opened captions server is easy:

# Create the Server
var OpenedCaptions = require('opened-captions');
var oc = new OpenedCaptions();

# Add a Stream
oc.addStream('random');

# Add a Better Stream
oc.addStream('server', {
  host: 'https://openedcaptions.com',
  port: 443,
  description: "CSPAN"
});

You also can use this example server to get started.

Tools

Tests are written in Mocha.