thijsr/subtitles

Modification and conversion of subtitle file formats

v1.0.2-beta 2016-04-15 22:39 UTC

Requires

• php: >=5.4.0

Requires (Dev)

• phpunit/phpunit: ^5.0

MIT

• Thijs Riezebeek

• subtitles
• srt
• subrip

README

This package contains the functionality to modify subtitle files. It is currently in a beta state and therefore names as well as APIs can and probably will change.

Functionality

• Delaying all subtitles in a file
• Fixing a 'broken' subtitle file by restoring the numbering.

Installation

The package can be installed using the following command:

composer require thijsr/subtitles

Or by adding it to your composer.json manually:

"require": {
  "thijsr/subtitles": ">=1.0.0-beta
}

Examples

Below is a simple example of reading in a .srt file, delaying it by 3200 milliseconds and writing it to a new file.

use \ThijsR\Subtitles\SubRip;

$subrip_file _= SubRip\Reader::readFile("path/to/srt/file.srt");
SubRip\Modifier::addDelayInMs($srt_file, 3200);
SubRip\Writer::writeFile($srt_file, "new/path/to/delayed/srt/file.srt");

Sometimes srt files cannot be opened in Media Players because the numbering is not correct. This example shows a fix for this.

use \ThijsR\Subtitles\SubRip;

$subrip_file _= SubRip\Reader::readFile("path/to/srt/file.srt");
SubRip\Modifier::restoreNumbering($subrip_file);
SubRip\Writer::writeFile($srt_file, "new/path/to/delayed/srt/file.srt");