NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #786 most downloaded on pub.dev
Flutter port of the official YouTube iFrame player API. Supports Android, iOS, macOS & Web.
Latest stable
6.0.2
Last release 5 months ago
30 May 2026
Release timing varies
gaps range from 9 days to 11 months
Most releases are documented
notes for 33 of 39 stable releases
1 version withdrawn
withdrawn after publishing
6 years old
42 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Added onEnded callback for YoutubePlayer widget. (Fixes #108)
(New Feature) Added title and author property to YoutubePlayerController.
title and author property to YoutubePlayerController.start and end from flags as it wasn't functioning anyway.Your coding agent can read these notes before it upgrades. Set up the MCP server →
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.(Improvement) Smooth fullscreen toggle and crash fix. #46 & #105
PlayerState.ended being call multiple times. #108controller parameter to all widgets. This comes handy when the widgets are to used outside the context of YoutubePlayer widget. #109BREAKING CHANGES
YoutubePlayerController is to be passed to the player explicitly. (See the updated readme)context and videoId properties from YoutubePlayer.flags property is moved to YoutubePlayerController from YoutubePlayer.
Since flags were only needed for the first time when player initializes.showVideoProgressIndicator property moved to YoutubePlayer.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
Renamed videoId property in YoutubePlayer to initialVideoId.
BREAKING CHANGES
videoId property in YoutubePlayer to initialVideoId.PlayerState.ended now calls only once. Added PlayerState.stopped.actionsPadding property.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
Renamed TotalDuration widget to RemainingDuration.
TotalDuration widget to RemainingDuration.PlayButton widget to PlayPauseButton.webview_flutter.Everything is modular now. See the docs for details.
BREAKING CHANGES
webview_flutter is swapped with ytview. If you've been using WebView widget, then consider changing import paths to ytview instead.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
YoutubePLayerScaffold has been removed.
BREAKING CHANGES
YoutubePLayerScaffold has been removed.webview_flutter instead of ytviewDec 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
BREAKING CHANGES See Migrating to 3.x.x for detail.
hideThumbnail and disableDragSeek flags. #27, #29.Aug 12, 2022
Breaking Change
webview_flutter.YoutubePlayerScaffold to better handle the fullscreen mode.Better full screen orientation change logic.
Toggles fullscreen on orientation change.
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
FIXED iOS playback is fully functional. Issue #2
forceHideAnnotation property which hides the default YouTube annotation. Read Issue #17 for detailmute player.Nothing published for this version
Added YoutubePlayerParams.privacyEnhanced flag.
YoutubePlayerParams.privacyEnhanced flag.gestureRecognizers through YoutubePlayerIFrame widget.>=1.22.0 <2.0.0 is required.Added actions property, which can be used to add menus in top bar of video. See example for details.
actions property, which can be used to add menus in top bar of video. See example for details.Built and tested on iOS device.
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
FIXED Video pausing on tapped, when controls were hidden.
- Minor Fixes
Initial release of youtube_player_iframe
Initial release of youtube_player_iframe
Includes support for Live Videos.
One column per quarter.