videojs-ass

Add Advanced SubStation Alpha (ASS) subtitles support to videojs using the libjass library.

Check out the demo here

Install

For plugin that supports videojs v5.x install using either:

• bower install videojs-ass

or

• npm install videojs-ass

For videojs v4:

Just specify version to be within:

"videojs-ass": ">=0.3.0 < 0.5.0"

for bower or npm whichever you prefer using.

Usage

Initialize the ass plugin with the src field like the following:

videojs('player_id', {
  plugins: {
    ass: {
      src: 'subs/subtitles.ass'
    }
  }
}

| Option | Default | Description | | ----------- | ------------- | ---------------------------------------------------------- | | src | -1 | .ass / .ssa source. | | label | -2 | subtitle track label that shows up in the subtitles picker | | delay | 03 | delay subtitle rendering by the specified value in seconds | | rate | 1 | subtitle update speed relative to video playback rate | | enableSvg | true | see here regarding SVG filter | | fontMap | - | see here regarding using custom web fonts | | fontMapById | - | alternate to above, takes id and runs this | | videoWidth | -4 | metadata to assist in determining the optimal (cont below) | | videoHeight | -4 | (cont) subtitle letterboxing ratio |

Footnotes:

1. This property is required!
2. Has fallback values but you should provide a better label.
3. Value can be negative
4. Generally, you should set these values when using external videojs providers as they might not expose the video dimensions to the player.