Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

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 -3 metadata to assist in determining the optimal (cont below)
videoHeight -3 (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.
You can’t perform that action at this time.