All Versions
Latest Version
Avg Release Cycle
45 days
Latest Release

Changelog History
Page 7

  • v3.0.8 Changes

    • ๐Ÿš‘ Vimeo hotfix for private videos
  • v3.0.7 Changes

    • Fix for keyboard shortcut error with fast forward
    • Fix for Vimeo trying to set playback rate when not allowed
  • v3.0.6 Changes

    • 0๏ธโƒฃ Improved the logic for the custom handlers preventing default handlers
  • v3.0.5 Changes

    • ๐Ÿšš Removed console messages
  • v3.0.4 Changes

    • ๐Ÿ›  Fixes for fullscreen not working inside iframes
    • 0๏ธโƒฃ Fixes for custom handlers being able to prevent default
    • ๐Ÿ›  Fixes for controls not hiding/showing correctly on Mobile Safari
  • v3.0.3 Changes

    • ๐Ÿ›  Vimeo offset tweak (fixes #826)
    • ๐Ÿ›  Fix for .stop() method (fixes #819)
    • ๐Ÿ›  Check for array for speed options (fixes #817)
    • โช Restore as float (fixes #828)
    • ๐Ÿ›  Fix for Firefox fullscreen oddness (Fixes #821)
    • ๐Ÿ›  Improve Sprite checking (fixes #827)
    • Fix fast-forward control (thanks @saadshahd)
    • Fix the options link in the readme (thanks @DanielRuf)
  • v3.0.2 Changes

    • Fix for Safari not firing error events when trying to load blocked scripts
  • v3.0.1 Changes

    • Fix for trying to accessing local storage when it's blocked
  • v3.0.0 Changes

    This is a massive release. A mostly complete rewrite in ES6. What started out as a few changes quickly snowballed. There's many breaking changes so be careful upgrading.

    Big changes

    • New settings menu complete with funky animations
    • Ability to adjust speed of playback
    • Ability to toggle caption language (HTML5 and Vimeo only)
    • Ability to set YouTube quality (HTML5 will follow)
    • ๐Ÿ‘ Added support for Vimeo captions
    • ๐Ÿ‘ Added Picture-in-Picture support (Safari only)
    • ๐Ÿ‘ Added AirPlay support (again, Safari only)
    • ๐Ÿ‘ Added playsinline support for iOS 10+
    • ๐Ÿšš Soundcloud removed until I can work on a plugin framework
    • Embedded players are now progressively enhanced - no more empty <div>s!

    Other stuff

    • Now using SASS exclusively. Sorry, LESS folk it just made sense to maintain one method as SASS is what the cool kids use. It may come back if we work out an automated way to convert the SASS
    • ๐Ÿšš Moved to ES6. All the rage these days. You'll need to look at polyfills. The demo uses
    • ๐Ÿ‘ Added basic looping support
    • Added an aspect ratio option for those that can't leave the 90s and want 4:3
    • controlshidden and controlsshown events added for when the controls show or hide
    • qualityrequested and qualitychange events for YouTube quality control (HTML5 will follow)
    • Volume is now 0 to 1 as per HTML5 spec
    • No longer bodging a <progress> behind the <input type="range"> to make up for WebKit's lack of lower fill styling
    • Captions now render with line breaks as intended
    • Captions now render without AJAX using the native events etc
    • Added a fallback for getting YouTube video data incase .getVideoData() disappears when one of their developers randomly deletes it again
    • ๐Ÿ— Setup and building of the UI should be way "snappier"
    • Click to toggle inverted time (e.g. 0:01 or -2:59 for a 3 minute video at 1 seconds) - new toggleInvert and invertTime options
    • Added autopause option for Vimeo
    • Added muted option for you guessed it, muted playback
    • โช Restored the .off() API method
    • .play() will now return a promise to prevent that pesky uncaught promise issue in Chrome etc
    • โšก๏ธ Pressing and hold the seek bar no longer freezes all other updates of the UI

    ๐Ÿ› loads of bug fixes.

    ๐Ÿ’ฅ Breaking changes

    You gotta break eggs to make an omelette. Sadly, there's quite a few breaking changes:

    • Setup now uses proper constructor, accepts a single selector/element/node and returns a single instance - much simpler than before
    • ๐Ÿ‘€ Much of the API is now using getters and setters rather than methods (where it makes sense) to match the HTML5 API - see the docs for more info
    • The data attributes for the embeds are now data-plyr-provider and data-plyr-embed-id to prevent compatibility issues. These can be changed under config.attributes.embed if required
    • blankUrl -> blankVideo
    • volume is now 0 to 1 as per HTML5 spec
    • keyboardShorcuts (typo) is now just keyboard
    • loop is now in preparation for loop enhancements later
    • ๐Ÿšš html option for custom controls removed in favour of the controls option which now accepts an array (to use built in controls) or a string of HTML for custom controls.
    • classes -> classNames
    • classes.videoWrapper ->
    • classes.embedWrapper -> classNames.embed
    • ๐Ÿšš classes.ready removed
    • ๐Ÿšš classes.setup removed
    • ๐Ÿšš classes.muted removed
    • ๐Ÿšš removed in favour of the :fullscreen selector
    • ๐Ÿšš selectors.html5 removed
    • ๐Ÿšš selectors.embed removed
    • ๐Ÿ‘€ ->
    • selectors.volume.input -> selectors.inputs.volume
    • selectors.volume.display -> selectors.display.volume
    • selectors.currentTime -> selectors.display.currentTime
    • selectors.duration -> selectors.display.duration


    ๐Ÿ— Because we're using the fancy new ES6 syntax, you will need to polyfill for vintage browsers if you want to use Plyr and still support them. Luckily there's a decent service for this that makes it painless, Alternatively, you can use the prebuilt polyfilled build but bear in mind this is 20kb larger. I'd suggest working our your own polyfill strategy.

  • v2.0.18 Changes

    • ๐Ÿ›  Fix for YouTube .getVideoData() issue (fixes #709)