youtube_player_flutter

May 31, 2026

• Patch release to trigger pub.dev documentation refresh.
• Bumps youtube_player_iframe dependency to ^6.0.2.

May 30, 2026

Breaking Changes

• Complete rewrite powered by youtube_player_iframe. The underlying engine has switched from flutter_inappwebview to the official YouTube IFrame API via webview_flutter. Most APIs have changed — see the README for the new API.
• YoutubePlayerBuilder has been removed. Fullscreen is now handled internally by the player.
• YoutubePlayerController is now re-exported from youtube_player_iframe. Refer to its changelog for the full API surface.
• Bumps minimum Flutter version to >=3.38.0 / Dart SDK ^3.10.0.

New Features

• Adds macOS and Web support.
• Adds built-in Material-style controls overlay with progress bar, playback speed picker, title bar, and fullscreen button.
• Adds YoutubePlayerTheme for customizing the default controls (colors, text styles).
• Adds YoutubePlayerThumbnail widget — shows a thumbnail and only initializes the WebView on tap, ideal for lists.

• Bumps dependencies to latest version.

• Fixes type error when handling YouTube error codes (error where int was expected as String).
• Improves error handling for YouTube error codes 150 and 152.

• Bumps flutter_inappwebview to latest version.

• Updates minimum supported SDK version to Flutter 3.24/Dart 3.5.
• Updates dependencies.

• Fixes related to fullscreen toggle.

• Fixes issue where loading indicator would always show.
• Updates the default color of the progress indicator to be primary container color.

• Fixes issue with getting error logs even after disposing player.

• Fixes issue with fullscreen pop.

• Bumps flutter_inappwebview to latest version.

• Bumps flutter_inappwebview to latest version.
• Adds support for extracting video id from YouTube Shorts & Music URL.

• Bumps flutter_inappwebview to latest version.
• Fixed cast error in YouTube error.

• Upgraded minimum flutter version to 3.0.0
• Upgraded example app

• Null Safety Release
• Added useHybridComposition flag

• (Fixed) random crashes
• (Fixed) issues with orientation
• (Improvements) Added automatic fullscreen toggle wrt to orientation change

BREAKING CHANGE

• Requires iOS: --ios-language swift, Xcode version >= 11
• Requires Android: minSdkVersion 17
• Removed exported WebView widget

• (Fixed) random crashes
• (Fixed) issues with orientation
• (Improvements) Added automatic fullscreen toggle wrt to orientation change
• Added YoutubePlayerBuilder
• (Fixed) progress color being ignored #221

BREAKING CHANGE

• Requires iOS: --ios-language swift, Xcode version >= 11
• Requires Android: minSdkVersion 17
• Removed exported WebView widget

• Added onEnterFullScreen & onExitFullScreen callback to YoutubePlayerBuilder.
• Player switches back to normal mode on system back, if on fullscreen.
• Added thumbnail parameter to YoutubePlayer, removed thumbnailUrl. Now any widget can be used as thumbnail.
• Fixed issues with progress colors.

• Added onEnterFullScreen & onExitFullScreen callback to YoutubePlayerBuilder.
• Player switches back to normal mode on system back, if on fullscreen.
• Added thumbnail parameter to YoutubePlayer, removed thumbnailUrl. Now any widget can be used as thumbnail.
• Fixed issues with progress colors.

• Fixed onExitFullScreen callback.

• Updated dependencies. Fixes #262
• Added clear error description for 101, 105 and 150 error codes.

• Revert padding on fullscreen.

• (Improvements) Added support for endAt in load and cue methods as well as startAt and endAt in video initialization.
• (Fixed) Sticky video watermarks in iOS. Fixes#208
• (Fixed) Timing and Sizing Issue #249

• Updated dependencies

• Removed forceHideAnnotation flag

• Removed forceHideAnnotation.

• (Fixed) Some videos not playing Issue #119
• (Improvements) Faster initial video loading time
• Added forceHD flag
• Shows buffer indicator until video is playable

BREAKING CHANGE If you're using webview_flutter alongside, then remove it from dependencies. The package exports webview on its own.

• Exports Webview

• Updated webview_media constraint to >=0.1.2<1.0.0

• Moved videoId, title, author and duration to separate YoutubeMetaData class.
• (Fixed) Issue with invalid video id being shown while switching to fullscreen. Issue #118

• (New Feature) Pinch in/out on the player to fit video.
• (Improvements) Video plays in high definition, if supported.

• Added onEnded callback for YoutubePlayer widget. (Fixes #108)
• Removed isEvaluationReady & isLoaded flags as it had no use anyway.
• Added controlsVisibleAtStart flag. (Fixes #113)

• (New Feature) Added title and author property to YoutubePlayerController.
• Removed DataConnectionChecker dependency.
• Removed start and end from flags as it wasn't functioning anyway.
• (Improvement) Implemented effective dart lints.
• (Improvement) Changed thumbnails to fetch webp format.
• (Fixed) Issue with Live UI Issue #115.

• (Improvement) Smooth fullscreen toggle and crash fix. Issue #46 & Issue #105
• (Fixed) Issue #93.
• (Fixed) PlayerState.ended being call multiple times. Issue #108
• (Improvement) Exposed controller parameter to all widgets. Issue #109. This comes handy when the widgets are to used outside the context of YoutubePlayer widget.
• (Improvement) UI and performance optimizations.

BREAKING CHANGES

• From now on, YoutubePlayerController is to be passed to the player explicitly. (See the updated readme)
• Removed 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.

5.2.0+1

• (Fixed) aspect ratio in fullscreen mode.
• (Fixed) sometimes showing up buffering indicator instead of error.

BREAKING CHANGES

• Renamed videoId property in YoutubePlayer to initialVideoId.
• From now on changing video id must be done using either load() or cue().
• (Fixed) Video playing sound only, on videoId change. Issue #99
• (Improvement) Minor optimizations.
• Example updated with video list.
• Added PlayerState.stopped.
• Added actionsPadding property.

• Renamed TotalDuration widget to RemainingDuration.
• Renamed PlayButton widget to PlayPauseButton.
• (Improvement) Better handling of invalid video id.
• (Improvement) Better video orientation handling.
• (Improvement) Better play/pause handling w/r/t app lifecycle.
• (Fixed) Video pausing after jumping to certain position using progress bar.
• BREAKING Switched back to webview_flutter.
• Updated dart docs.

BREAKING CHANGES

• Everything is modular now. See the docs for details.
• Automatically switches to landscape on fullscreen mode.
• Added proper display of errors and detects internet connection status.
• Workarounds for iOS.
• webview_flutter is swapped with ytview. If you've been using WebView widget, then consider changing import paths to ytview instead.
• Added flags to enable/disable caption and looping.
• Added flags to change caption language, start and end time of video.

• Feature Added Button to change playback rate in player.
• Added setPlaybackRate method to YoutubePlayerController. Issue #48
• (Improvement) Playback behaviour synced with AppLifeCycle Issue #41

BREAKING CHANGES

• YoutubePLayerScaffold has been removed.
• Improved Orientations
• Uses webview_flutter instead of ytview

• Fix error reports in LiveUI. PR#44
• Added startAt property.

• BREAKING CHANGES See Migrating to 3.x.x for detail.
• Faster fullscreen toggling.
• Toggles fullscreen on orientation change. Issue #3.
• Option to add own custom thumbnail.
• (Fixed) Video stuck at unknown state Issue #24.
• Added hideThumbnail and disableDragSeek flags. #27, #29.
• (Fixed) Fullscreen toggle in iOS.
• Minor UI improvements here and there.

• (Fixed) iOS playback is fully functional. Issue #2
• Added forceHideAnnotation property which hides the default YouTube annotation. Read Issue #17 for detail
• Added option to mute player.

• Added actions property, which can be used to add menus in top bar of video. See example for details.
• Added option to hide fullscreen button.
• (Fixed) Current position always showing 00:00 Issue #17

• Fix for issue #12.
• WebView is now exported alongside YoutubePlayer.

• Updated dart constraint to >=2.2.0 <3.0.0*.
• (Fixed) Parsing Exceptions.

• Minor Improvements.
• Built and tested on iOS device.
• Migrated to AndroidX.
• Removed warnings on iOS builds.

• Fixed Disabled navigation inside the player. This solves the issue where tapping on actions would navigate to different web pages.
• Removed foreceHD param, in favor of desktopMode. The desktopMode also supports changing quality in fullscreen mode.
• Added two new methods, hideTopMenu() and hidePauseOverlay(). Visit ReadMe for more detail.

• (Fixed) Error while building for iOS.

• Added Travis CI.

• Initial Release.
• Includes Dart Documentation.
• Includes support for Live Videos.
• Includes fast forward and rewind feature.