@qgustavor/ass-parser

ass-parser

Parse SSA/ASS subtitle format. Forked from eush77/ass-parser.

Changes:

• All dependencies replaced with native modern JavaScript functions.
• ES Modules instead of CommonJS.
• Add detectStringifyOptions helper function.

Demo

https://codepen.io/qgustavor/full/YzaRXeX

API

assParser(text, [options])

Default export. Returns the parse tree.

Comments are ignored unless options.comments is set.

Option	Type	Required?	Default
comments	boolean	No	false
parseTimestamps	boolean	No	false

Format

Subtitle is a list of sections, each of them has section and body properties. The body is a list of key-value bindings (descriptors), with key and value properties (type === 'comment' and value for comments).

value can be one of the following:

• array if the descriptor key is "Format";
• object if there is a "Format" descriptor above in the section;
• string otherwise.

When parseTimestamps is set to true timestamps on Start and End keys for Dialogue and Comment lines will be converted into numbers (in seconds).

At the moment override tags are not parsed.

detectStringifyOptions(text)

Named export. Returns an options object to be passed to stringify in order to parse then stringify a subtitle with the minimal differences possible.

References

• Wikipedia page
• Format specification

Related

• @qgustavor/ass-stringify - stringify SSA/ASS parse tree.

Install

npm install @qgustavor/ass-parser

License

MIT