Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including videojs-thumbnails with all npm packages installed. Try it out:

var videojsThumbnails = require("videojs-thumbnails")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

videojs-thumbnails v1.0.3

Thumbnails images on video progress bar.


Thumbnails images on video progress bar. Example of the thumbnail: Thumbnail example

The plugin works with sprites. Example of sprite generated from the video: Thumbnail sprite example


npm install --save videojs-thumbnails

The npm installation is preferred, but Bower works, too.

bower install  --save videojs-thumbnails


To include videojs-thumbnails on your website or web application, use any of the following methods.

<script> Tag

This is the simplest case. Get the script in whatever way you prefer and include the plugin after you include video.js, so that the videojs global is available. Setup and initialisation below is an example of thumbnail shown in the screenshot above. Depending on the ratio of your video you will generate specific size of the sprite so some adjustments to variable to best position and display thumbnails. The sprite created in the example is 100th px ( depending on the video length ) wide and 58px high with the clip width of 100px ( see example above ).

<script src="//path/to/video.min.js"></script>
<script src="//path/to/videojs-thumbnails.min.js"></script>
  var player = videojs('my-video');
  // example of setup for specific size of the sprite
  // adjust if necessary 
        // width of the single sprite clip
        width: 100,
        // url to sprite image
        spriteUrl: "//path/to/sprite.jpg",
        // how often to change thumbnail on timeline ( ex. every 2sec )
        stepTime: 2,


Thumbnail styles need to be also included for thumbnails to work correctly.

 <link href="//path/to/videojs-thumbnails.css" rel="stylesheet">

To adjust style simply overide style in css file. For example .vjs-thumbnail-img class padding, background and height.


When using with Browserify, install videojs-thumbnails via npm and require the plugin as you would any other module.

var videojs = require('video.js');

// The actual plugin function is exported by this module, but it is also
// attached to the `Player.prototype`; so, there is no need to assign it
// to a variable.

var player = videojs('my-video');



When using with RequireJS (or another AMD library), get the script in whatever way you prefer and require the plugin as you normally would:

require(['video.js', 'videojs-thumbnails'], function(videojs) {
  var player = videojs('my-video');



MIT. Copyright (c) Mariusz Rajczakowski <>


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free