PHPackages saeven/subtitles - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. saeven/subtitles ActiveLibrary[Utility & Helpers](/categories/utility) saeven/subtitles ================ Subtitle converter and generator for PHP 03.4k↓33.3%1PHP Since Apr 6Pushed 1y agoCompare [ Source](https://github.com/Saeven/subtitles)[ Packagist](https://packagist.org/packages/saeven/subtitles)[ RSS](/packages/saeven-subtitles/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (4)Used By (0) Caption And Subtitle Converter for PHP ====================================== [](#caption-and-subtitle-converter-for-php) Convert and edit subtitles and captions. Supported formats ----------------- [](#supported-formats) FormatExtension[SubRip](https://en.wikipedia.org/wiki/SubRip#SubRip_text_file_format).srt[WebVTT](https://en.wikipedia.org/wiki/WebVTT).vtt[Youtube Subtitles](https://webdev-il.blogspot.lt/2010/01/sbv-file-format-for-youtube-subtitles.html).sbvInstallation ------------ [](#installation) ``` composer require saeven/subtitles ``` Fork Notes ---------- [](#fork-notes) This package was forked from `mantas-done/subtitles` (thank you) to become more opinionated, to implement strict types and new interfaces, and to implement proper PSR-4 loading. What's more, this version of that package removes all ability to manipulate files directly or to attempt to infer the existence of converters by scanning the filesystem with file\_exists and so forth. It also resorts to pattern matching in cases where the original implementation would split strings. Lastly, it adds Carbon to perform time conversions. Usage ----- [](#usage) Convert .srt content to .vtt: ``` // add namespace use \Circlical\Subtitles\Subtitles; (new Subtitles())->load($srtContent, 'srt')->content('vtt'); ``` Manually create VTT ``` $subtitles = new Subtitles(); $subtitles->add(0, 5, 'This text is shown in the beggining of video for 5 seconds'); file_put_contents( './foo', $subtitles->content('subtitles.vtt')); ``` Load subtitles from string ``` $string = " 1 00:02:17,440 --> 00:02:20,375 Senator, we're making our final approach "; $subtitles = Subtitles::load($string, 'srt'); ``` Get file content without saving to file ``` echo $subtitles->content('vtt'); ``` Add subtitles ``` $subtitles->add(0, 5, 'some text'); // from 0, till 5 seconds // Add multiline text $subtitles->add(0, 5, [ 'first line', 'second line', ]); ``` Remove subtitles ``` $subtitles->remove(0, 5); // from 0, till 5 seconds ``` Add 1 second to all subtitles ``` $subtitles->shiftTime(1); ``` Subtract 0.5 second ``` $subtitles->shiftTime(-0.5); ``` Add 5 second to subtitles starting from 1 minute till 2 mintes ``` $subtitles->shiftTime(5, 60, 120); ``` Example: shift time gradually by 2 seconds over 1 hour video. At the beginning of the video don't change time, in the middle shift time by 1 second. By the end of video, shift time by 2 seconds. ``` $subtitles->shiftTimeGradually(2, 0, 3600); ``` ### "Internal Format" [](#internal-format) "Internal Format" is just a PHP array. It is used internally in library to be able to convert between different formats. ``` Array ( [0] => Array ( [start] => 137.44 [end] => 140.375 [lines] => Array ( [0] => Senator, we're making [1] => our final approach into Coruscant. ) ) [1] => Array ( [start] => 140.476 [end] => 142.501 [lines] => Array ( [0] => Very good, Lieutenant. ) ) ) ``` ``` [start] - when to start showing text (float - seconds) [end] - when to stop showing text (float -seconds) [lines] - one or more text lines (array) ``` Running Tests ------------- [](#running-tests) ``` ./vendor/bin/phpunit ``` Contribution ------------ [](#contribution) Not all original converters from the fork have been corrected. Feel free to convert one from the 'todo' folder and open a PR! Report Bugs ----------- [](#report-bugs) If some file is not working with the library, please create and issue and attach the file. ### Health Score 24 — LowBetter than 32% of packages Maintenance29 Infrequent updates — may be unmaintained Popularity22 Limited adoption so far Community13 Small or concentrated contributor base Maturity27 Early-stage or recently created project Bus Factor1 Top contributor holds 85.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/887224?v=4)[Alexandre Lemaire](/maintainers/Saeven)[@Saeven](https://github.com/Saeven) --- Top Contributors [![mantas-done](https://avatars.githubusercontent.com/u/17127206?v=4)](https://github.com/mantas-done "mantas-done (116 commits)")[![Saeven](https://avatars.githubusercontent.com/u/887224?v=4)](https://github.com/Saeven "Saeven (9 commits)")[![kocoten1992](https://avatars.githubusercontent.com/u/7130705?v=4)](https://github.com/kocoten1992 "kocoten1992 (7 commits)")[![ntninja](https://avatars.githubusercontent.com/u/246386?v=4)](https://github.com/ntninja "ntninja (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")[![ts-toh](https://avatars.githubusercontent.com/u/41636305?v=4)](https://github.com/ts-toh "ts-toh (1 commits)") ### Embed Badge ![Health badge](/badges/saeven-subtitles/health.svg) ``` [![Health](https://phpackages.com/badges/saeven-subtitles/health.svg)](https://phpackages.com/packages/saeven-subtitles) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)