Fix for cleanUp being called twice (thanks to @sebastiancarlsson)
Fix for YouTube controls on iPad (fixes #391)
v2.0.10
Added seek event fixes for Vimeo and YouTube (fixes #409)
Added support for embed URLs rather than ID only (fixes #345)
v2.0.9
Temporary patch for the YouTube API issues with getDuration() (relates to #374)
v2.0.8
Added isPaused() API method (thanks to @darrena092)
Allowed .on() API method to be chainable (thanks to @gurupras) (fixes #357)
Improved the “awful” rendering of captions on small screens in fullscreen mode (fixes #390)
Fix for Firefox VTT compatibility (thanks to @magourex)
Fix for Firefox Developer Edition blank video due to -webkit-mask-image issue (fixes #392)
Added Issue and PR templates with the aim of reducing duplicate or duff issues
v2.0.7
Fixed getCurrentTime() method (fixes #351)
Added getVolume() , isMuted() and getDuration() API methods (fixes #346)
v2.0.6
Fixed merge issue with Updated define to work with AMD imports #326 PR
Code formatting
v2.0.5
Fix for Vimeo in IE9 & IE10
Fix for HTML5 elements not firing ready event
v2.0.4
Fix for Firefox full screen (fixes #343)
v2.0.3
Set ‘global’ keyboard shortcut option to false as default, added <textarea> to editable elements to be ignored
v2.0.2
Added ‘global’ keyboard shortcut option
v2.0.1
Version bump for NPM (sorry for folks who upgraded to the now deleted v1.9.0 through NPM)
v2.0.0
This version contains several potential breaking changes:
setup() has been reverted to pre v1.8.0 behaviour; meaning it will return the instance rather than the element. This is because the reference to the instance is no longer added to the original element (see below).
The reference to the plyr instance is now added to the media element rather than original container. This is because if a container with multiple children was passed to setup() the references to all instances would have been added to the container, creating issues. I would recommend using the return value from setup() or the new get() method to access the instance.
Players will always be wrapped in their own div now - this makes setup() and destroy() cleaner. This may break any custom styling based on DOM position.
Players no longer seek to 0 on ‘ended’ - this is to fix a bug with Microsoft Edge as it triggers ‘ended’ on media change for whatever reason. They’ll never change ;-)
And some other changes and bug fixes:
New get() method on the global plyr object to get all instances inside a container
New API methods:
getOriginal() to get the original, unmodified element plyr was setup on (<video>, <audio> or empty <div> for YouTube and Vimeo)
getContainer() to get the players outer wrapper element
getMedia() to get the players media element (<video>, <audio> or empty <div> for YouTube and Vimeo)
getEmbed() to access the YouTube or Vimeo API directly
getType() to get the type of the player
isReady() to determine if an instance has completed setup and necessary APIs are loaded (for YouTube / Vimeo)
on() to provide an easy way to listen to events
stop() to, you guessed it, stop the player
destroy() now works correctly for YouTube and Vimeo (fixes #272)
New destroyed event when destroy() has completed (original element is passed as event.target)
Default volume is now 10 (max) rather than 5
Sprite is only loaded once (fixes #259)
Fixes for Vimeo post message bugs on source change or destroy (fixes #318)
Save caption state in storage (fixes #311)
Added keyboard shortcuts to the current focused player (with keyboardShortcuts boolean option to disable) (fixes #309)
Fix for captions bug (fixes #332)
Change to AMD (fixes #298)
v1.8.12
Vimeo keyboard focus fix (Fixes #317)
Fix for Vimeo on basic support devices
v1.8.11
Fix for keyboard navigation on Vimeo (Fixes #317)
Fix for bug introduced in v1.8.9 related to additional controls
Vimeo API upgrade
Fix for YouTube bug introduced in v1.8.9
Added support for passing array to .setup() (Fixes #319)
v1.8.10
Fix for seek issues introduced in v1.8.9
v1.8.9
Fix for fullscreen not being defined (Fixes #295)
Fix for multiline captions (Fixes #314)
Clean up of type checks and fix for restart() (Fixes #315)
Fix for MEDIA_ERR_SRC_NOT_SUPPORTED when calling .source() API method
v1.8.8
Added getCurrentTime API method (fixes #292)
Fix for !hideControls on touch devices (fixes #303)
v1.8.7
Line height fix
v1.8.6
Reverted font size change
v1.8.5
Fixed overflow issues (fixes #286)
v1.8.4
Fix for large play button on small videos
v1.8.3
Disabled iPad support for YouTube and Vimeo due to iOS limitations with iFrame playback
Fixed IE11 icon loading (fixes #269)
Updated screenshot (fixes #281)
Added WordPress plugin (fixes #239)
Added Neos plugin
Added HLS, Shaka and dash.js examples (see #235 for more)
Improvements for controls hiding and showing on touch devices
v1.8.2
Fixed event bubbling
v1.8.1
Fixed inaccurate log message
v1.8.0
(Important)setup() now returns the element Plyr was setup on rather than the plyr object. This means var player = plyr.setup()[0]; would now be var player = plyr.setup()[0].plyr;. This improves support for React and other virtual dom frameworks as mentioned in #254
Fixed using a relative URL for iconUrl in IE (fixes #269)
v1.7.0
SASS cleanup (fixes #265)
Docs tidy up to help quick start (fixes #253)
Fix for issues with data attribute options passing (fixes #257)
(Important) Removed the requirement for a wrapper div to setup Plyr and removed the dependency on the plyr classname as a JS hook. By default it will now look for <video>, <audio> and [data-type] elements. If you are just calling setup() with a <div class="plyr"> you may want to give it a good test after upgrading. You can probably remove the wrapper div. The reason behind this is to make setup easier for newcomers and prevent the styling being used on unsupported players (because the plyr classname was used as a CSS and JS hook - which isn’t ideal)
Renamed the ‘docs’ folder to demo to avoid confusion - the readme is the docs after all
v1.6.20
Fix for multiple sprites being requested (fixes #259)
v1.6.19
Fix for scroll direction issues on volume control (fixes #258)
v1.6.18
Reduced rounding of seek value from 1 decimal point to 4 (fixes #242)
v1.6.17
Added disableContextMenu option to hide the right click context menu (fixes #248 and #225)
v1.6.16
Always hide standard controls (fixes #225)
Fix for Tooltips overflowing (fixes #230)
v1.6.15
Restore scroll position when exiting full screen (fixes #236)
v1.6.14
SVG sprite loading automatically for an easier setup
Touch devices now show controls on touch rather than pausing playback
v1.6.13
Decreased sensitivity and inverted scroll on volume slider (scroll up to increase, down to decrease)
v1.6.12
Fix for undefined buffer error
Add scroll listener on volume slider (PR #227 bty @igoradamenko)
v1.6.11
Fix for Vimeo fullscreen (fixes #214)
v1.6.10
Changed default icon prefix from ‘icon’ to ‘plyr’ to avoid clashes
v1.6.9
Added ‘latest’ CDN option
Renamed sprite.svg to plyr.svg to be inline with the other package files
v1.6.8
Fix for bug introduced in v1.6.7
v1.6.7
Fixes for using source API method on iOS
v1.6.6
Icons cleaned up
IE11 button fix for tooltips (fixes #210)
v1.6.5
IE UI bug fixes
v1.6.4
Bug fix for undefined progress bar
v1.6.3
Seek back to 0 for all media on ended
Check for HTML5 video on ended reload
Update to docs for showPosterOnEnd option
v1.6.2
Fix for tooltip displaying when duration is not set (fixes #177)
showPosterOnEnd option to show poster when HTML5 video ended (fixes #59)
Error handler for YouTube (fixes #189)
Initial SoundCloud support (fixes #194)
Other minor bug fixes
v1.6.1
Tooltip changes for accessibility
v1.6.0
New, cleaner, UI:
Controls are now overlaid, maintaining the video’s ratio and making sizing easier
A large play button can now be overlaid over videos
Default number of control buttons reduced
New play, pause, rewind and fast forward icons
Flexbox all the things!
Tidied up the LESS (and SCSS) as part of the above, variables and mixins in seprate files amking customization and upgrades easier
Toggle mute bug fix; if a player was muted previously and the user refreshed, unmuting would have meant volume was still zero (effectively muted), now the config default value is used. Not ideal but good for now
New iconUrl option allowing specifying a same origin SVG sprite location. Loading this way means you don’t need the AJAX sprite loading JavaScript
click option renamed to clickToPlay to make it a bit more self explanatory. Unfortunately cross origin SVG sprites is not supported in any browser yet :-(
hideControls is now a global option, rather than being exclusive to fullscreen. Controls are now hidden after 2 seconds of no mouse movement. Controls are always shown when media is paused or stopped. This is defaulted to true.
sass folder in src renamed from to scss
v1.5.21
Bug fix for embeds: play not being defined (fixes #185 and #186)
v1.5.20
Bug fix for autoplay option
v1.5.19
Fix for accessing embed property after ready event fired
v1.5.18
Added ‘ready’ event for initial setup complete or source change occurs
Fixed SASS stylesheet references to transparentize
Added default font stack to controls
Docs fixes inc controls HTML (fixes #180)
v1.5.17
Expose YouTube and Vimeo API (docs update required) (fixes #176)
Auto set title based on YouTube getVideoData() title property
Bug fix for Vimeo API change (Uncaught TypeError: Cannot read property ‘value’ of undefined) due to a change their end
v1.5.16
Cancel requests on source change (fixes #174)
v1.5.15
Fix for CustomEvent polyfill and related bug (see #172)
v1.5.14
Volume storage fix (fixes #171)
v1.5.13
Fix for manual caption rendering
v1.5.12
Added a duration option to pass the duration of the file
Added the ability to set options per element by setting a data-plyr attribute on the target elements (this might be useful for the duration option for example)
Fixes for Chrome and Safari caption rendering, they now use the default texttrack and cuechange events
Firefox bug fix for event not defined
v1.5.11
iOS embed bug fixes (fixes #166)
Hide IE/Edge tooltip (since we have a styled one) (fixes #160)
SASS bug fix for default values (fixes #158)
v1.5.9 + v1.5.10
NPM bug fixes
v1.5.8
Fix for touch device seek tooltip
Seek improvements
v1.5.7
Fix for control tooltips always showing
v1.5.6
Seek tooltip (option for tooltips changed, please check docs)
SASS compile error fixes (fixes #148)
Fullscreen fixes for controls not always hiding/showing (fixes #149)
Screen reader icon fixes (title was being read twice due to the tooltip/hidden label)
v1.5.5
Fixed controls.md example
Bug fix for docs error page
Bug fix for controls tooltips
v1.5.4
Minor bug fix for clicking video to play/pause after source change
v1.5.3
Minor bug fix for occasional display of 0:00 as the media duration
v1.5.2
handlers option renamed to listeners
Added event listeners for all types to the plyr container (playback, fullscreen, captions etc - see docs)
Removed onSetup config option (use the ‘setup’ event instead, plyr element is event.plyr)
Style bug fixes
Vimeo seek bug fix (requires whole seconds when seeking)
Fix for fullscreen player (using class hook, not browser fullscreen)
v1.5.1
Fix for event listeners being duplicated on source change
v1.5.0
Vimeo support (fixes #8)
New options for initialization (you can now pass a selector, HTMLElement or NodeList) (fixes #118)
Switched to BEM methodology (you will need to change CSS and probably HTML)
Decoupled CSS and JS hooks (fixes #129)
Custom controls container (fixes #98)
Fix for private/incognito mode local storage bug (fixes #131)
UMD module setup (fixes #121)
Specify iframe title for Vimeo and YouTube (fixes #124)
Better handling of mission controls (fixes #132)
Retain classname on source change (fixes #120)
Increased thumb size on seek (partially fixes #130)
Passing no argument to source api method, now returns current source (by @gurupras)
Ability to add custom handlers to controls prior to Plyr bindings (by @gurupras)
Keyboard navigation improvements (focus on seek, focus trap in fullscreen) (fixes #135)
v1.3.5
Fixed bug with API use on basic supported browsers
v1.3.4
Code cleanup by @calvintam236
v1.3.3
Removed captions being read by screen readers
v1.3.2
Voiceover fix for captions
v1.3.1
ARIA improvements for captions being read
v1.3.0
Internationalization support (i18n) using default controls (required markup changes to controls)
ARIA enhancements for controls (required markup changes to controls)
Captions legibility improvements
YouTube bug fixes
v1.2.6
SASS updates and fixes (cheers @ChristianPV)
v1.2.5
Fix for YouTube quality (let them decide quality)
v1.2.4
Fix for omitted kind attribute on (fixes #88)
v1.2.3
Fix for YouTube on iPhone or unsupported browsers (fallback to YouTube native)
Docs tidy up
Fullscreen for Safari fix (fixes #96)
v1.2.2
Fix for :focus keyboard vs mouse (fixes #61)
Fix for caption positioning in full screen (fixes #92)
v1.2.1
Tooltip bug fix
v1.2.0
Added YouTube support
v1.1.13
Added icon prefix option for when using default controls
v1.1.13
Logic tweaks for hiding controls in fullscreen
v1.1.12
Bug fix for Chrome Canary
v1.1.11
Bug fix
v1.1.10
Bug fix
v1.1.9
Bug fix for 1.1.8
v1.1.8
setVolume API method improvements (fixes #83)
v1.1.7
Restore classname on destroy()
v1.1.6
New API methods (fixes #77), Fix for non strict mode (fixes #78)
v1.1.5
Fix for incorrect isFullscreen() return value in Mozilla (fixes #38)
v1.1.4
Minor bug fixes
v1.1.3
Fixes for random id used in controls with multiple instances and one call to setup
Audio player UI improvements
v1.1.2
Added an onSetup callback option
Added fullscreen API methods toggleFullscreen() (must be user iniated), and isFullscreen()
v1.1.1
Fix for unsupported browser handling
Fix for config.controls having no effect
v1.1.0
Added config option to set which controls are shown (if using the default controls html) and better handling of missing controls
v1.0.31
Display duration on metadataloaded
v1.0.30
Fixed bug with media longer than 60 minutes (fixes #69)
v1.0.29
Added option to hide controls on fullscreen (default true) while palying, after 1s. Pause, mouse hover on progress, or focus on a child control re-shows the controls. On touch a tap of the video (which plays/pauses the video by default) is required. (fixes #47)
Fixed a bug with caption toggle in 1.0.28
v1.0.28
Added API support for browsers that don’t have full plyr support (pretty much <=IE9 and <video> on iPhone/iPod)
v1.0.27
Keyboard accessibility improvements (fixes #66)
v1.0.26
Fixes for SASS (cheers @brunowego)
Indentation reset to 4 spaces
v1.0.25
Fixes for iOS volume controls (hidden)
Classnames for left/right controls changed
v1.0.24
Added tooltip option to display labels as tooltips (fixes #50)
v1.0.23
Handling loading states in the UI (fixes #36)
v1.0.22
Added support() API method for checking mimetype support
Added source() API method for setting media source(s) (fixes #44)
Added poster() API method for setting poster source
Refactored captions logic for manual captions
v1.0.21
Added an for seeking to improve experience (and support dragging) (fixes #40, #42)
Icons for restart and captions improved (and some IDs changed) (fixes #49)
v1.0.20
Default controls included (Fixes #45)
Volume changes on input as well as change (fixes #43)
Fix for undefined Play text
License changed to MIT
v1.0.19
Fixed firefox fullscreen issue (fixes #38)
v1.0.18
Added CDN references
v1.0.17
SASS support added (thanks to @brunowego)
Docs completely separated to avoid any confusion
New gulp tasks (will add more documentation for this)
v1.0.16
Aria label is now dynamic
v1.0.15
Fix for seek time display in controls
More documentation for controls html
v1.0.14
Minor change for bootstrap compatibility
v1.0.13
Minor tweaks
v1.0.12
Handle native events (issue #34)
v1.0.11
Bug fixes for fullscreen mode
v1.0.10
Bower includes src files now
Folder re-arrangement
v1.0.9
Added buffer progress bar
Fixed Safari 8 caption track (it needs to be removed from the DOM like in Safari 7)
Added validation (it works or it doesn’t basically) of the html option passed
v1.0.8
Bug fix
v1.0.7
Storing user selected volume in local storage
v1.0.6
Fullscreen fallback for older browsers to use “full window”