Skip to content
Video.js - open source HTML5 & Flash video player
JavaScript CSS HTML
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github chore: add Affects: a11y and switch to outdated label (#6015) May 28, 2019
build test: run tests via rollup (#5601) Aug 30, 2019
docs feat: option to load text tracks on demand vs preload (#6043) Nov 4, 2019
lang fix(lang): Fixed typos in german translation (#6275) Nov 4, 2019
sandbox feat: allow displaying of multiple text tracks at once (#5817) Jun 18, 2019
src fix(sass): import path has cwd once again (#6326) Dec 2, 2019
test fix(extend): super_ should be available for backwards compatibility (#… Nov 22, 2019
.babelrc chore(babel): Upgrade to Babel 7 (#5498) Oct 12, 2018
.editorconfig Added .editorconfig and travis CI badge Dec 11, 2012
.gitignore feat: add core ES module. (#6287) Nov 15, 2019
.jsdoc.json fix: broken logo link in README and docs (#6345) Dec 3, 2019
.npmignore feat: add core ES module. (#6287) Nov 15, 2019
.nvmrc chore: switch to node 8 (#4813) Dec 14, 2017
.remarkignore chore(docs): Documentation Linting and TOC generation (#3841) Dec 20, 2016
.remarkrc.js chore(docs): Documentation Linting and TOC generation (#3841) Dec 20, 2016
.travis.yml chore: fix xvfb in travis config, patch safari karma launchers (#5755) Jan 15, 2019
CHANGELOG.md 7.7.3 Dec 2, 2019
CODE_OF_CONDUCT.md docs(coc): introduce CODE_OF_CONDUCT.md (#4160) Mar 23, 2017
COLLABORATOR_GUIDE.md docs: use https links (#5749) Jan 18, 2019
CONTRIBUTING.md docs: use https links (#5749) Jan 18, 2019
LICENSE More build and testing cleanup. Also some reorganization. Apr 2, 2015
README.md fix: broken logo link in README and docs (#6345) Dec 3, 2019
composer.json chore(https): update a lot of links to be https (#5372) Aug 10, 2018
index.html chore: add a sandbox page for testing autoplay values. (#5933) Apr 29, 2019
package-lock.json 7.7.3 Dec 2, 2019
package.json 7.7.3 Dec 2, 2019
postcss.config.js feat(css): run autoprefixer on css (#5239) Jun 21, 2018
rollup.config.js fix: turn on strict mode again (#6334) Dec 2, 2019

README.md

Video.js logo

Video.js - HTML5 Video Player

Build Status Coverage Status Greenkeeper badge Slack Status

NPM

Video.js is a web video player built from the ground up for an HTML5 world. It supports HTML5 and Flash video, as well as YouTube and Vimeo (through plugins). It supports video playback on desktops and mobile devices. This project was started mid 2010, and the player is now used on over 50,000 100,000 200,000 400,000 websites.

Table of Contents

Quick Start

Thanks to the awesome folks over at Fastly, there's a free, CDN hosted version of Video.js that anyone can use. Add these tags to your document's <head>:

<link href="//vjs.zencdn.net/7.3.0/video-js.min.css" rel="stylesheet">
<script src="//vjs.zencdn.net/7.3.0/video.min.js"></script>

For the latest version of video.js and URLs to use, check out the Getting Started page on our website.

Video.js version 7 (and newer) CDN builds do not send any data to Google Analytics.

In older versions of Video.js (6 and earlier), in the vjs.zencdn.net CDN-hosted versions we include a stripped down Google Analytics pixel that tracks a random sampling (currently 1%) of players loaded from the CDN. This allows us to see (roughly) what browsers are in use in the wild, along with other useful metrics such as OS and device. If you'd like to disable analytics, you can simply include the following global before including Video.js via the free CDN:

<script>window.HELP_IMPROVE_VIDEOJS = false;</script>

Alternatively, you can include Video.js by getting it from npm, downloading from GitHub releases or by including it via unpkg or another JavaScript CDN like CDNjs. These releases do not include Google Analytics tracking at all.

<!-- unpkg : use the latest version of Video.js -->
<link href="https://unpkg.com/video.js/dist/video-js.min.css" rel="stylesheet">
<script src="https://unpkg.com/video.js/dist/video.min.js"></script>

<!-- unpkg : use a specific version of Video.js (change the version numbers as necessary) -->
<link href="https://unpkg.com/video.js@6.11.0/dist/video-js.min.css" rel="stylesheet">
<script src="https://unpkg.com/video.js@6.11.0/dist/video.min.js"></script>

<!-- cdnjs : use a specific version of Video.js (change the version numbers as necessary) -->
<link href="https://cdnjs.cloudflare.com/ajax/libs/video.js/6.7.3/video-js.min.css" rel="stylesheet">
<script src="https://cdnjs.cloudflare.com/ajax/libs/video.js/6.7.3/video.min.js"></script>

Next, using Video.js is as simple as creating a <video> element, but with an additional data-setup attribute. At a minimum, this attribute must have a value of '{}', but it can include any Video.js options - just make sure it contains valid JSON!

<video
    id="my-player"
    class="video-js"
    controls
    preload="auto"
    poster="//vjs.zencdn.net/v/oceans.png"
    data-setup='{}'>
  <source src="//vjs.zencdn.net/v/oceans.mp4" type="video/mp4"></source>
  <source src="//vjs.zencdn.net/v/oceans.webm" type="video/webm"></source>
  <source src="//vjs.zencdn.net/v/oceans.ogv" type="video/ogg"></source>
  <p class="vjs-no-js">
    To view this video please enable JavaScript, and consider upgrading to a
    web browser that
    <a href="https://videojs.com/html5-video-support/" target="_blank">
      supports HTML5 video
    </a>
  </p>
</video>

When the page loads, Video.js will find this element and automatically setup a player in its place.

If you don't want to use automatic setup, you can leave off the data-setup attribute and initialize a <video> element manually using the videojs function:

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

The videojs function also accepts an options object and a callback to be invoked when the player is ready:

var options = {};

var player = videojs('my-player', options, function onPlayerReady() {
  videojs.log('Your player is ready!');

  // In this context, `this` is the player that was created by Video.js.
  this.play();

  // How about an event listener?
  this.on('ended', function() {
    videojs.log('Awww...over so soon?!');
  });
});

If you're ready to dive in, the Getting Started page and documentation are the best places to go for more information. If you get stuck, head over to our Slack channel!

Contributing

Video.js is a free and open source library, and we appreciate any help you're willing to give - whether it's fixing bugs, improving documentation, or suggesting new features. Check out the contributing guide for more!

Video.js uses BrowserStack for compatibility testing.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License

Video.js is licensed under the Apache License, Version 2.0.

You can’t perform that action at this time.