This is a media player that uses all the goods of HTML5 video/audio elements to play the most popular media in MP4/MP3, HLS and M(PEG)-DASH, and also has the ability to play VMAP, VAST and VPAID ads.
No new features or additions will be added, only bug fixes.
- Supports all modern browsers.
- No dependencies, since it is written in Typescript.
- Runs a simple but yet powerful algorithm to check the browser's autoplay capabilities across browsers.
- Enhance your player adding your own buttons. Check here for more details.
- Provides the ability to use a single VAST/VPAID source or a VAST/VPAID playlist from several different sources (including URLs and valid XML strings).
- Can play ads in infinite loop, desired for ads that are in a heavy text page.
- Always responsive by default, for both video/audio tags; for video,
fill
andfit
modes are available to either scale and crop media relative to its parent container, or to attempt to make the media fit its parent container (including black bars), respectively.
To learn more details about how to migrate from 1.x.x version to 2.x.x, or any breaking changes in newer versions, visit the Migration document.
The standard template to start using OpenPlayerJS is show in the following snippet.
<html>
<head>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/openplayerjs@latest/dist/openplayer.min.css" />
</head>
<body>
<video class="op-player__media" id="player" controls playsinline>
<source src="/path/to/video.mp4" type="video/mp4" />
<track kind="subtitles" src="/path/to/video.vtt" srclang="en" label="English" />
</video>
<script src="https://cdn.jsdelivr.net/npm/openplayerjs@latest/dist/openplayer.min.js"></script>
<script>
// Check the `API and events` link below for more options
const player = new OpenPlayerJS('player');
player.init();
</script>
</body>
</html>
If you want to unleash the power of OpenPlayerJS, learn more about OpenPlayerJS by checking the following links.
If you need a reference on how to use OpenPlayerJS in some of the most common scenarios, check the following links:
- No configuration (only DOM classes)
- Minimal configuration
- Using
fill
mode - Using
fit
mode - Using Ads (linear and non-linear samples)
- Removing controls and using
preload="none"
- Using
Levels
and setting width/height - Use FLV source (only modern browsers and Android, not iOS)
- OpenPlayerJS with React
- OpenPlayerJS with Next.js
- OpenPlayerJS with Vue.js
- YouTube video (using plugin)
- Using hls.js p2p plugin
- Add source after initialization
- Playing HLS streaming with DRM (Encryption)
- M(PEG)-DASH with Ads
- Ads playlist (multiple URLs)
- Add a custom element (watermark)
- Updating source and Ads for dynamic content loading
- Updating Ads and clickable Ad element
- Trigger Ad manually
- Fully customized audio player
- Basic playlist (video and audio)
- Retrieve data from audio streaming (HLS)
- Seamless transitions between media using custom control
- Typescript - The Javascript for Pros.
- Rafael Miranda - rafa8626
See also the list of contributors who participated in this project.
This project is licensed under the MIT License - see the LICENSE.md file for details.