NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #903 most downloaded on pub.dev
Flutter port of the official YouTube iFrame player API. Supports Android, iOS, macOS & Web.
Last release 4 months ago
30 May 2026
Release timing varies
gaps range from 9 days to 11 months
Most releases are documented
notes for 30 of 39 stable releases
1 version withdrawn
withdrawn after publishing
6 years old
42 releases · first in 2020
Patch release to trigger pub.dev documentation refresh.
May 31, 2026
Removes the deprecated modestbranding player parameter (dropped by YouTube in 2023).
May 31, 2026
credentialless to YoutubePlayerController and YoutubePlayerController.fromVideoId. On web, enables credentialless iframe mode for pages with Cross-Origin-Embedder-Policy set.videoStateUpdateInterval to YoutubePlayerParams. Controls how often (in milliseconds) the player polls for current time and loaded fraction while playing. Defaults to 100 (10 Hz), preserving existing behaviour.videoUrl getter returning a quote-wrapped string on some platforms.playlist and availablePlaybackRates throwing a FormatException when called before a playlist or video is loaded.getPlaylist returns an empty response.loadVideo to accept all YouTube URL formats: watch, youtu.be, /shorts/, /embed/, and music.youtube.com.modestbranding player parameter (dropped by YouTube in 2023).PlayerState and YoutubeError enums.One column per quarter.
Removes YoutubePlayerScaffold. Use YoutubePlayer directly. Fullscreen is now handled internally. See the migration guide in the README.
May 16, 2026
Breaking Changes
YoutubePlayerScaffold. Use YoutubePlayer directly. Fullscreen is now handled internally. See the migration guide in the README.>=3.38.0 / Dart SDK ^3.10.0.New Features
YoutubePlayerThumbnail widget. Shows the video thumbnail and only creates the WebView when the user taps, making it ideal for lists.privacyEnhancedMode to YoutubePlayerParams (default true). Uses youtube-nocookie.com so YouTube won't track visitors unless they play the video.copyWith to YoutubePlayerParams.ThumbnailQuality and ThumbnailFormat enums for YoutubePlayerController.getThumbnail.videoId crash in controller.Bumps dependency to latest version.
Aug 7, 2025
Bumps dependency to latest version.
Nov 16, 2024
Updates minimum supported SDK version to Flutter 3.24/Dart 3.5.
Sep 23, 2024
Aug 13, 2024 - Updates readme - Improves pub score
Aug 13, 2024
Bumps dependency to latest version.
Aug 3, 2024
Bumps dependency to latest version.
Jul 1, 2024
Bumps dependency to latest version.
Apr 12, 2024
Feb 21, 2024 - Improves pub score.
Feb 21, 2024
Bumps dependency to latest version.
Feb 21, 2024
Bumps dependency to latest version.
Dec 20, 2023
>=3.18.0-0.WebViewWidget from webview_flutter package, together with the package.Fixed platform listing in pub.dev
Jan 29, 2023
Endorse youtube_player_iframe_web as default web implementation package.
Jan 29, 2023
youtube_player_iframe_web as default web implementation package.Fixed issue with YoutubePlayerController.close.
Jan 27, 2023
YoutubePlayerController.close.YoutubePlayerValue.Fixed video playback issue in web release.
Dec 26, 2022
Deprecated params in v3 has been removed.
Dec 25, 2022
Breaking Change
YoutubePlayerIFrame has been removed.YoutubePlayer.controller is now required.YoutubePlayerController.onInit has been removed. As unlike before, the controller is available as soon as it's created.YoutubePlayerController.getCurrentPositionStream has been deprecated in favor of YoutubePlayerController.videoStateStream.YoutubePlayerController.onFullscreenChange has been deprecated in favor of YoutubePlayerController.setFullScreenListener.YoutubePlayerParams.pointerEvents. Thanks to @keithcwk.Deprecated startAt & endAt from *YoutubePlayerParams*.
Sep 15, 2022
strictRelatedVideos flag working incorrectly. Thanks to @ChisatoMatsuzaki.startAt & endAt from YoutubePlayerParams.volume from YoutubePlayerValue as it's no longer used.Deprecated YoutubePlayerIFrame in favor of YoutubePlayer.
Aug 21, 2022
YoutubePlayerController.fromVideoId.enableFullScreenOnVerticalDrag property to YoutubePlayer.videoUrl getter.getCurrentPositionStream to YoutubePlayerController.YoutubePlayerIFrame in favor of YoutubePlayer.autoPlay param in YoutubePlayerParams, as it's no longer used.Deprecated autoPlay param in YoutubePlayerParams , as it's no longer used.
onInit & onFullscreenChange callbacks to YoutubePlayerController.Swipe up/down to enter/exit fullscreen mode as a feature in the docs.autoPlay param in YoutubePlayerParams, as it's no longer used.hasPlayed, position & buffered from YoutubePlayerValue, as these values can be accessed through YoutubePlayerController.Aug 14, 2022
onInit & onFullscreenChange callbacks to YoutubePlayerController.Swipe up/down to enter/exit fullscreen mode as a feature in the docs.autoPlay param in YoutubePlayerParams, as it's no longer used.hasPlayed, position & buffered from YoutubePlayerValue, as these values can be accessed through YoutubePlayerController.Aug 12, 2022 - Improved pub score.
Aug 12, 2022
Fixed the supported platform in pub.dev
Aug 12, 2022
APIs are now identical to that of Youtube Player Iframe API.
Aug 12, 2022
Breaking Change
webview_flutter.YoutubePlayerScaffold to better handle the fullscreen mode.Nothing published for this version
Nothing published for this version
Upgraded minimum flutter version to 3.0.0
May 16, 2022
3.0.0YoutubePlayerController.setWebDebuggingInAndroidContains Breaking Changes
YoutubePlayerController is no more Stream.YoutubePlayerController.setWebDebuggingInAndroidbuildWhen to YoutubeValueBuilderdesktopMode flag.useHybridComposition param.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added YoutubePlayerParams.privacyEnhanced flag.
YoutubePlayerParams.privacyEnhanced flag.gestureRecognizers through YoutubePlayerIFrame widget.>=1.22.0 <2.0.0 is required.Nothing published for this version
Fixed Black Screen on iOS #302.
Fixed Disabled navigation inside the player. This solves the issue where tapping on actions would navigate to different web pages.
foreceHD param, in favor of desktopMode. The desktopMode also supports changing quality in fullscreen mode.hideTopMenu() and hidePauseOverlay(). Visit ReadMe for more detail.Nothing published for this version
Nothing published for this version
- Minor Fixes
Initial release of youtube_player_iframe
Initial release of youtube_player_iframe
- Initial Release
Your coding agent can read these notes before it upgrades. Set up the MCP server →