NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev
A Flutter video player for YouTube and direct video URLs with adaptive controls. Supports Android, iOS, Windows, macOS, Linux, and Web.
Latest stable
2.0.3
Last release 14 days ago
08 Nov 2026
Ships fairly regularly
a new release about every 2 months
Most releases are documented
notes for 14 of 16 stable releases
Nothing withdrawn
no release was ever pulled
9 months old
16 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
Fix (WASM import graph): Removed direct dart:io platform checks from shared PiP/player code, conditionally exported the local HTTP server, and kept th
dart:io platform checks from shared PiP/player code, conditionally exported the local HTTP server, and kept the native caching package export out of web builds.kotlin.compilerOptions and removed legacy Kotlin plugin and android.kotlinOptions configuration.flutter analyze reports no issues.fix: Android built-in Kotlin migration
fix: Android built-in Kotlin migration
android/build.gradle from legacy buildscript {} + apply plugin: pattern to modern declarative plugins {} block, resolving the pub.dev "Legacy Kotlin configuration detected" warning.Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
Feature (Background Auto-PiP across Native Platforms):
autopictureinpicture HTML attribute support with continuous MutationObserver synchronization. Supported Chromium browsers now automatically pop out the video into native OS PiP upon switching tabs or navigating away during active playback.380x214) positioned at the bottom-right corner without enlarging or getting stuck in full-size.AVPictureInPictureController.canStartPictureInPictureAutomaticallyFromInline, synchronous background playback coordination, and automatic unmute/mute state handoff.PictureInPictureParams.Builder.setAutoEnterEnabled(true).onUserLeaveHint listener support in AdaptiveVideoPlayerPlugin and example MainActivity.NormalVideoPlayer.RenderFlex overflow errors in MobilePlayerChrome by dynamically adjusting vertical padding, hiding top bar when height < 95px, and scaling transport controls with FittedBox.Release draft: use after the version has been published and verified.
Since the published 1.3.3 baseline, the package adds browser fullscreen and desktop window handling, expanded PiP integration, chapter timelines, capsule controls, hold-to-2× playback, audio/subtitle panels, a speed picker, episodes, and optional caching/capture controls. It also introduces unified configuration, native Android/iOS integration and a refreshed example app.
PiP, caching, codecs and capture controls depend on the OS, browser, backend and host setup. Web automatic PiP is not guaranteed. macOS desktop window services need host method-channel integration. Capture controls are not DRM, and YouTube embedding permissions still apply.
Migration: import package:adaptive_video_player/adaptive_video_player.dart, configure through VideoConfig, review removed legacy/internal imports, and complete the platform setup. See branch and migration details, README and CHANGELOG.
Before publishing this note, add the final verification results, actual device/browser test evidence and the official score for the published version. Use real screenshots alongside any image labeled as a concept mockup.
Full WASM Readiness & Platform Support (20/20 on pub.dev):
dart:io leakage into Flutter Web and WASM compiler graphs by migrating adaptive_controls.dart to use conditional web-safe video player abstractions.AdaptiveVideoPlayerPlatform) into platform_init_io.dart and platform_init_stub.dart, isolating desktop/IO-specific backends (video_player_media_kit) from Web and WASM targets.Feature (Localization): Added customizable and localizable text labels in PlayerTextConfig:
PlayerTextConfig:
qualityText: Label for video resolution/quality selection menu (defaults to 'Quality (Resolution)').autoText: Label for automatic quality resolution (defaults to 'Auto').subtitlesText: Label for subtitles menu (defaults to 'Subtitles').offText: Label for disabled subtitles track (defaults to 'Off').noQualitiesAvailableText: SnackBar feedback message when no resolutions are available (defaults to 'No qualities available').noSubtitlesAvailableText: SnackBar feedback message when no subtitles are available (defaults to 'No subtitles available').AdaptiveControlsLayer bottom bar with flexible and overflow-safe time layout (Expanded, Flexible, FittedBox), preventing render overflow issues on smaller mobile screens.settingsBackgroundColor and settingItemTextStyle with floating behavior.Maintenance: Achieved full WebAssembly (WASM) compatibility on Flutter Web.
video_player imports to conditionally route to a native re-export or a custom web-safe controller/widget implementation.dart:io import in the official video_player package for web builds.video_player_platform_interface explicitly in the dependencies list.Maintenance: Upgraded youtube_player_flutter to version 10.0.1.
youtube_player_flutter to version 10.0.1.
StreamBuilder and listen to controller.videoStateStream asynchronously.android, ios, linux, macos, web, windows) in pubspec.yaml to ensure correct scoring on pub.dev.Major Feature: Added full Windows and Linux platform support — package now supports all 6 platforms (20/20 on pub.dev).
video_player_win for normal video playback (compatible with flutter_inappwebview).video_player_media_kit (media_kit backend) for normal video playback.AdaptiveVideoPlayerPlatform.ensureInitialized() — a single-line setup to enable desktop video playback in your main().Nothing published for this version
Nothing published for this version
Documentation: Complete README overhaul with comprehensive usage examples, full configuration reference tables, platform permissions & setup guide, FA
Major Feature: Added Live Stream support with a dynamic "LIVE" indicator and adjustable Viewer Count (isLive, viewerCount).
isLive, viewerCount).controlsBuilder, subtitleBuilder) for complete custom overlay creation.chewie dependency out completely and engineered a fully integrated and adaptive built-in custom video playback control logic.dart:html with package:web completely, making the package 100% WASM ready for advanced Web platform outputs.Fix NormalVideoPlayer playback on Web not rendering (removed dart:io dependency internally)
NormalVideoPlayer playback on Web not rendering (removed dart:io dependency internally)Fix web platform compatibility issue from underlying dart:io import
Enhanced platform architecture, fixed displays, and updated utilities and test dependencies
Adaptive video player with automatic YouTube/direct video detection