PHPackages                             emgag/video-thumbnail-sprite - 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. [Image & Media](/categories/media)
4. /
5. emgag/video-thumbnail-sprite

AbandonedArchivedLibrary[Image & Media](/categories/media)

emgag/video-thumbnail-sprite
============================

PHP library for generating video thumbnail sprites

v1.0.3(8y ago)275.8k16[1 issues](https://github.com/emgag/video-thumbnail-sprite/issues)MITPHPPHP 7.\*

Since May 19Pushed 3y ago2 watchersCompare

[ Source](https://github.com/emgag/video-thumbnail-sprite)[ Packagist](https://packagist.org/packages/emgag/video-thumbnail-sprite)[ Docs](https://github.com/emgag/video-thumbnail-sprite)[ RSS](/packages/emgag-video-thumbnail-sprite/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (7)Versions (7)Used By (0)

video-thumbnail-sprite
======================

[](#video-thumbnail-sprite)

[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Packagist Version](https://camo.githubusercontent.com/6bf08a78cd260ae16a36dbe268867c400b6e918644f108ead2988b814432cb7c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f656d6761672f766964656f2d7468756d626e61696c2d7370726974652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/emgag/video-thumbnail-sprite)

**WARNING**: This library is no longer maintained **/WARNING**

PHP library for generating video thumbnail sprites to be used for thumbnails in [JWPlayer](https://support.jwplayer.com/customer/portal/articles/1407439-adding-preview-thumbnails)'s seek bar.

System requirements
-------------------

[](#system-requirements)

PHP 7.x (see [release 0.2](https://github.com/emgag/video-thumbnail-sprite/tree/v0.2) for the latest version supporting PHP 5.5/5.6).

Following binaries need to be installed

- Either [ffmpeg](http://www.ffmpeg.org/download.html) (tested with >= v2.2) or [ffmpegthumbnailer](https://github.com/dirkvdb/ffmpegthumbnailer)
- [imagemagick](http://www.imagemagick.org/script/binary-releases.php) (tested with >= v6.6)

Installation
------------

[](#installation)

```
composer require emgag/video-thumbnail-sprite

```

Usage
-----

[](#usage)

```
use Emgag\Video\ThumbnailSprite\ThumbnailSprite;

$sprite = new ThumbnailSprite();
$ret = $sprite->setSource('path-to-source-video.mp4')
       ->setOutputDirectory('dir-to-store-sprite-and-vtt')
       // filename prefix for image sprite and WebVTT file (defaults to "sprite", resulting in "sprite.jpg" and "sprite.vtt")
       ->setPrefix('sprite')
       // absolute URL of sprite image or relative to where the WebVTT file is stored
       ->setUrlPrefix('http://example.org/sprites')
       // sampling rate in seconds
       ->setRate(10)
       // minimum number of images (will modify sampling rate accordingly if it would result in fewer images than this)
       ->setMinThumbs(20)
       // width of a single thumbnail in px
       ->setWidth(120)
       ->generate();

// $ret = ['vttFile' => 'path-to-vtt-file', 'sprite' => 'path-to-sprite-file']
```

There are two different thumbnailing methods available, [ffmpeg](http://www.ffmpeg.org/download.html) (default) or [ffmpegthumbnailer](https://github.com/dirkvdb/ffmpegthumbnailer).

```
// default, is set implicitly if not provided
$sprite->setThumbnailer(new Thumbnailer\Ffmpeg());
// change thumbnailer to ffmpegthumbnailer
$sprite->setThumbnailer(new Thumbnailer\FfmpegThumbnailer());
```

To keep individual source images of the sprite instead of removing it after assembling the sprite into a single image:

```
$sprite->setOutputImageDirectory('dir-to-store-images');
```

Acknowledgments
---------------

[](#acknowledgments)

- Inspired by [vlanard/videoscripts](https://github.com/vlanard/videoscripts) and [scaryguy/jwthumbs](https://github.com/scaryguy/jwthumbs).
- Thanks to [Mehrdad-Dadkhah](https://github.com/Mehrdad-Dadkhah) for adding ffmpegthumbnailer support and other additional features.

Uses:

- [captioning/captioning](https://github.com/captioning/captioning)
- [emgag/flysystem-tempdir](https://github.com/emgag/flysystem-tempdir)
- [intervention/image](https://github.com/Intervention/image)
- [php-ffmpeg/php-ffmpeg](https://github.com/PHP-FFMpeg/PHP-FFMpeg)
- [symfony/process](https://github.com/symfony/Process)
- [thephpleague/flysytem](https://github.com/thephpleague/flysystem)

License
-------

[](#license)

video-thumbnail-sprite is licensed under the [MIT License](http://opensource.org/licenses/MIT).

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 86.2% 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.

###  Release Activity

Cadence

Every ~213 days

Recently: every ~233 days

Total

6

Last Release

2950d ago

Major Versions

v0.2 → v1.0.02017-08-05

PHP version history (3 changes)v0.1PHP >=5.5

v1.0.0PHP ~7.0.0|~7.1.0

v1.0.1PHP 7.\*

### Community

Maintainers

![](https://www.gravatar.com/avatar/35a34580a28286ae22173cc8f34f42699d846067c976e8e39fdc23b8ad0cf44a?d=identicon)[emgag](/maintainers/emgag)

---

Top Contributors

[![maetthu](https://avatars.githubusercontent.com/u/1193955?v=4)](https://github.com/maetthu "maetthu (50 commits)")[![Mehrdad-Dadkhah](https://avatars.githubusercontent.com/u/3860685?v=4)](https://github.com/Mehrdad-Dadkhah "Mehrdad-Dadkhah (8 commits)")

---

Tags

ffmpegffmpegthumbnailerjwplayerphpspritesthumbnailvideoffmpegspritejwplayerffmpegthumbnailer

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/emgag-video-thumbnail-sprite/health.svg)

```
[![Health](https://phpackages.com/badges/emgag-video-thumbnail-sprite/health.svg)](https://phpackages.com/packages/emgag-video-thumbnail-sprite)
```

###  Alternatives

[php-ffmpeg/php-ffmpeg

FFMpeg PHP, an Object Oriented library to communicate with AVconv / ffmpeg

5.0k21.7M165](/packages/php-ffmpeg-php-ffmpeg)[pbmedia/laravel-ffmpeg

FFMpeg for Laravel

1.8k4.8M23](/packages/pbmedia-laravel-ffmpeg)[mehrdad-dadkhah/hls-video-generater

PHP library for generating video m3u8 playlist

241.4k](/packages/mehrdad-dadkhah-hls-video-generater)[pulse00/ffmpeg-bundle

Symfony bundle to provide PHP-FFmpeg as a Symfony service (https://github.com/alchemy-fr/PHP-FFmpeg)

57447.2k1](/packages/pulse00-ffmpeg-bundle)[lakshmaji/thumbnail

Thumbnails for videos

108122.2k](/packages/lakshmaji-thumbnail)[amnuts/jwplayer-thumbnail-preview-generator

A simple but effective command-line tool for generating thumbnails of a video, and corresponding VTT file, for use within JW Player to allow for toolbar video preview.

561.6k](/packages/amnuts-jwplayer-thumbnail-preview-generator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)