videojs-ass

0.8.0 • Public • Published

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.

Package Sidebar

Install

npm i videojs-ass

Weekly Downloads

64

Version

0.8.0

License

Apache-2.0

Last publish

Collaborators

  • sunnyok