parseSRT
A standalone and dependency-free function to parse and convert SRT subtitle data into JSON format. This has been adapted from the popcorn.js SRT parse plugin source code. The code to parse the SRT data is basically the same, with some differences in how the data is output.
Installation
Via Bower
bower install parse-srt
Via NPM
npm install parse-srt
Usage
parseSRT is an UMD module. You can load it into your application either by importing the module, or loading the script in your page.
If you are importing the parseSRT module via Webpack, Browserify or similar, make sure that the module name parse-srt is being resolved correctly to the Bower or NPM packages folder.
Via ES6 syntax
import parseSRT from 'parse-srt'
Via CommonJS syntax
var parseSRT = require('parse-srt')
Via the script tag
<script src="/scripts/parseSRT.js"></script> // Change the path as necessary
API
parseSRT(String data)
Parse and convert a SRT subtitles file data into JSON format.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| data | String | false |
'' | The contents of a SRT subtitles file to be converted. If empty, an empty array will be returned. |
Returns
[Array] - An array containing an object for each subtitle.
Example
var jsonSubs = parseSRT(srtData)
The subtitle object has the following structure:
| Property | Type | Description |
|---|---|---|
| id | Number | The subtitle ID number, which corresponds to the order in the sequence of subtitles present in the SRT file. |
| start | Number | The start timestamp in seconds |
| end | Number | The end timestamp in seconds |
| text | String | The contents of the subtitle. HTML tags are kept for styling. |
Brower support
parseSRT, although not tested in all of them, was created using features supported by these browsers.
- Android Browser 4+
- Blackberry Browser 7+
- Chrome 13+
- Firefox 4+
- Internet Explorer 9+
- Opera 12+
- Opera Mini 5+
- Safari 7+
Support
If you want to request new features or find any bugs, please open a ticket on the issues page and I'll review it as soon as possible.
Authors and Contributors
Created by Luís Rodrigues (@MrSlide)
License and copyright
Released under the MIT license
Copyright (c) 2016 Luís Rodrigues