JW Player is the world's most popular embeddable media player.
JavaScript CSS HTML
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github Hook: Run Karma Locally (#2284) Aug 29, 2017
assets Remove old font icons Sep 26, 2017
docs 8.2.0-beta.2 Mar 9, 2018
libs-external Fix playlist error handling after api.load Nov 12, 2015
src Merge pull request #2798 from jwplayer/v8.2.x Mar 21, 2018
test Merge pull request #2798 from jwplayer/v8.2.x Mar 21, 2018
.eslintignore Remove .eslintignore entries that have been de-linted Aug 1, 2017
.eslintrc ESLint clean up (#2720) Feb 12, 2018
.gitignore Update ignore files Sep 22, 2017
.npmignore Update npmignore file Sep 22, 2017
.project.default default FlashBuilder files May 15, 2014
.stylelintrc Improve timeslider UI and controlbar background (#2246) Aug 21, 2017
.travis.yml Add DangerJS (#2736) Feb 22, 2018
CONTRIBUTING.md New docs (#1654) Jan 5, 2017
Gruntfile.js Replace PhantomJS with Headless Chrome (#2673) Mar 21, 2018
LICENSE Adding our CC license, human-readable version below Jul 1, 2014
README.md Cleanup README git pre-push hook step Mar 5, 2018
_config.yml Set theme jekyll-theme-minimal Jul 6, 2017
accessibility.md Deprecate Dock Jul 25, 2017
browserslist Improve timeslider UI and controlbar background (#2246) Aug 21, 2017
dangerfile.js Add DangerJS (#2736) Feb 22, 2018
jwplayer.license.notice.js Add license banner to JS build output (#2759) Mar 6, 2018
karma.conf.js Replace PhantomJS with Headless Chrome (#2673) Mar 21, 2018
package.json Replace PhantomJS with Headless Chrome (#2673) Mar 21, 2018
postcss.config.js Place postcss config in a place thats easier for processes to find. Apr 4, 2017
test-context.js updated unit tests Aug 24, 2017
webpack.config.js Make license notice banner comment important Mar 7, 2018
yarn.lock Replace PhantomJS with Headless Chrome (#2673) Mar 21, 2018


JW Player Logo

Plays everywhere, every time.

Live on over 2 million sites with 1.3 billion unique plays per month, JW Player is the solution for seamless video playback across browsers and media types. It empowers the developer to interact with video programmatically to create unique and awesome user experiences.


This is the non-commercial version of JW Player. It does not contain the same features as the commercial-use player available from jwplayer.com. Commercial use and access to features requires a license. Learn more at https://www.jwplayer.com/pricing/. If you are a paid customer and want a player, please download it from the "Downloads" section of your JW Dashboard.

Official Documentation

A Simple Example

The example below will render a video player into the div with the player id, listens to an event, and makes a few calls using the API.

<!DOCTYPE html>
    <script src='LINK_TO_YOUR_PLAYER'></script>
    <div id="player">Loading the player...</div>
        // Setup the player
        const player = jwplayer('player').setup({
            file: 'LINK_TO_YOUR_FILE.mp4'

        // Listen to an event
        player.on('pause', (event) => {
            alert('Why did my user pause their video instead of watching it?');

        // Call the API
        const bumpIt = () => {
            const vol = player.getVolume();
            player.setVolume(vol + 10);

Check out an interactive example in this JSFiddle.


We appreciate all contributions towards the player! Before submitting an issue or PR, please see our contributing docs here.

Building the Player

We use grunt and a few npm scripts to build the player, lint code, and run tests. Debug code is built to /bin-debug, while minified & uglified code is built to /bin-release. Code is built with webpack, linted with eslint, and tested with karma, mocha and chai.


  1. Node.js and npm


  1. Fork the project, clone your fork, and set up the remotes:
# Clone your fork of the repo into the current directory
git clone https://github.com/<your-username>/jwplayer
# Navigate to the newly cloned directory
cd jwplayer
# Assign the original repo to a remote called "upstream"
git remote add upstream https://github.com/jwplayer/jwplayer
  1. Install the dependencies:
# Install grunt globally
npm install -g grunt
npm install
# Optionally, install webpack-dev-server
npm install -g webpack-dev-server
  1. Build the player:
# Build once
# Complete Watch - builds JS, lints, and tests on each change
grunt serve
# Quick JS Watch - build only. Requires webpack-dev-server to be installed globally
webpack-dev-server -w --env.debug --port 8888 --output-public-path /bin-debug/
  1. Test your code:
# All browsers
grunt test
# Individual browsers - chrome, firefox, safari
grunt karma:{BROWSER} e.g. grunt karma:chrome
  1. Lint your code:
npm run lint
  1. Setup git pre-push hook This will add a pre-push script to the project's .git/hooks folder that will lint and run unit tests on the branch before any push.
grunt hooks

Software License

The use of this library is governed by a Creative Commons license. You can use, modify, copy, and distribute this edition as long as it’s for non-commercial use, you provide attribution, and share under a similar license. http://www.jwplayer.com/license/