vvbv / videojs-ass

Advanced SubStation Alpha subtitle plugin for videojs

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.
button	true	add subtitle display toggle button to video control bar
delay	02	delay subtitle rendering by the specfied 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	-3	metadata to assist in determing optimal (cont below)
videoHeight	-3	(cont) subtitle letterboxing ratio

Footnotes:

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