better_player 1.18.0

Advanced video player for Flutter with HLS, DASH, DRM, subtitles, caching, PiP, playlists, and custom controls.

1.18.0

• Added: setPlayerSubtitlesConfiguration on BetterPlayerController to dynamically update subtitle styling at runtime (#1141).
• Fixed: Prevented NaN and Infinity errors in progress bars and aspect ratio calculations when media duration or size is zero (#1157, #1044, #901, #884).
• Fixed: Preserved fullscreen state when advancing or returning to a track in BetterPlayerPlaylistController (#1037).
• Fixed: Executed playerVisibilityChangedBehavior callback even when handleLifecycle is false (#939).
• Fixed: Rebuilt player controls immediately when setPlayerControlsConfiguration is called (#1000).
• Fixed: Resolved HLS subtitle segment URLs via Uri.resolve and forwarded data source headers when fetching HLS subtitle playlists (#992).
• Fixed: Resolved relative HLS/DASH variant and subtitle URLs against the final redirected URL when the master playlist redirects (#1005).
• Fixed: Applied controlsConfiguration.backgroundColor to the fullscreen Scaffold in PlayerFullScreenVideo (#1054).
• Fixed: Emitted PlayerEventType.exception when runtime errors occur on the video event stream after initialization (#1014).
• Fixed: Corrected off-by-one index mapping for asmsTrackNames in the quality selection menu when the Auto track is present (#1352).
• Fixed: Prevented rapid clicks on adjacent bottom bar controls in PlayerWebControls from triggering the video area's double-tap fullscreen gesture, and ensured PlayerWebControls acquires keyboard focus for shortcuts.
• Fixed: Guarded PlayerEngineController against post-dispose platform calls and ValueNotifier updates when disposed mid-initialization, and prevented duplicate event listeners on BetterPlayerPlaylistController.setupDataSourceList.
• Fixed: Restarted the position polling timer in PlayerEngineController.seekTo when already playing so the seekbar continues advancing after skip forward/backward or tap-to-seek.
• Fixed: Increased bottom padding in PlayerSubtitlesDrawer when controls are visible so subtitles do not overlap the bottom control bar, and preserved zero-based WebVTT cues when X-TIMESTAMP-MAP specifies LOCAL:00:00:00.000.
• Fixed: Synced video fit widget initialization and playback flags when PlayerControllerEvent.setupDataSource fires after setup completes, preventing the video texture from staying hidden on initial autoPlay.

1.17.0

• [BREAKING_CHANGE] Updated: Standardized class and file naming by replacing the BetterPlayer prefix with Player across internal widgets and utilities (including exported PlayerAsmsUtils and PlayerUiUtils; automatable via dart fix --apply).

1.16.0

• Added: Bundled better_player-usage Dart package skill (skills/better_player-usage/) with 1.x setup, controls, DRM, subtitles, caching, playlist, and migration references for AI coding agents.
• Fixed: Ignored stale completion and error events when a setupDataSource call is superseded by a newer data source, and added semantics container/identifier to BetterPlayerWebErrorWidget.

1.15.0

• Updated: Modernized Material UI controls with gradient overlays, refined button hierarchies, full-width progress bars, cleaner bottom sheet spacing, rounded progress bar edges, accurate ripple behaviors, and larger tap targets.
• Updated: Modernized Cupertino UI controls with pill-shaped bottom bar, centered play/pause/skip buttons, and expanding scrubber handle.

1.14.0

• Fixed: Resolved various documentation inconsistencies where properties were either missing, misassigned, or misspelled across general_configuration.md, controls_configuration.md, data_source_configuration.md, and subtitles_configuration.md.

1.13.0

• Added: enableReplay to BetterPlayerControlsConfiguration to allow hiding the replay button when a video finishes.
• Fixed: Video playback ignoring startAt configuration on Android when showNotification is enabled (#1024).
• Fixed: Blocked HLS pre-caching attempts on Android, iOS, and Dart. Pre-caching HLS streams natively caches only the playlist file (causing 0% progress bugs on Android and silent bypasses on iOS).
• Fixed: Picture in Picture (PiP) start and stop events (PlayerEventType.pipStart and PlayerEventType.pipStop) are now properly emitted on Android when PiP is toggled programmatically via enablePictureInPicture and disablePictureInPicture.
• Fixed: Exception where PlayerEngineController was used after being disposed by aborting background initialization when the controller is destroyed.
• Fixed: FormatException during DASH manifest parsing of fractional frame rates which resulted in missing quality tracks.
• Fixed: DASH subtitle BaseURL incorrectly parsing relative paths by using standard Uri resolution.

1.12.0

• Added: Configurable list of playback speeds via PlayerControlsConfiguration.playbackSpeeds (defaults to 0.25 - 2.0).
• Added: Configurable Android Auto Frame Rate (AFR) matching via BetterPlayerController.setAndroidMatchFrameRate(bool).
• Added: playPreviousVideo() method to BetterPlayerController and BetterPlayerPlaylistController to support playlist backward navigation.
• Fixed: Improved track detection and selection logic for ASMS (HLS/DASH) streams, including better fallback for missing dimensions and proper variant identification.
• Added: BetterPlayerController.currentVideoSize getter to retrieve the runtime dimensions of the currently playing stream rendition.
• Updated: Enhanced PlayerLogger to include textureId in logs, facilitating better debugging for multi-player scenarios.

1.11.0

• Added: Supported RTSP streaming on Android via androidx.media3:media3-exoplayer-rtsp.
• Added: Prevented player initialization for RTSP streams on iOS, Web, and Desktop, gracefully failing with a clear UI error instead of a native crash.
• Fixed: Resolved issue where a fatal stream initialization error (like a 403 Forbidden) resulted in an infinite loading spinner instead of the error overlay by preserving engine state during data source setup failures.
• Fixed: Corrected class names and types in rtsp_page.dart example to fix compilation errors.
• Fixed: Fullscreen mode on Android now extends behind notches and system UI elements to remove black strips (#1246).
• Added: pubspec.yaml descriptions and topics across all packages for better pub.dev discoverability.
• Updated: README.md and documentation to include AI agent guidelines, llms.txt, and competitor comparisons.
• Fixed: Dispatch changedPlaylistItem event on playlist video change.
• Fixed: Double/Triple screen glitch on setResolution() by sequencing setupDataSource controller events.
• Fixed: Race conditions in unit tests for data source setup.
• Fixed: controlsHideTime not respected in Material and Cupertino controls (#1278).
• Added: metadataReady event to signal when all adaptive tracks and subtitles are fully parsed and available (#1370).
• Fixed: Conditionally disabled onDoubleTap in player controls to eliminate the 300ms single-tap lag when no custom double-tap gesture is provided.
• Fixed: Separated controls visibility timer (controlsHideTime) and transition animation duration (controlsTransitionTime) to prevent instantaneous hiding of controls.

1.10.0

• Added: WebVTT metadata block parsing support for NOTE, STYLE, and REGION headers.
• Added: Integrated custom inline tag parser for WebVTT cues, supporting HTML bold, italic, underline, and variable color classes.
• Added: Supported parsing of X-TIMESTAMP-MAP blocks with 33-bit MPEG-TS rollover timing adjustment corrections.
• Added: Supported WebVTT cue positioning attributes for individual text alignment customization (align:left, align:right, align:center).
• Fixed: Resolved layout and visibility calculation overlap for stroke-based text outlines using layered RichText stacks.

1.9.0

• Fixed: Resolved "No MaterialLocalizations found" and "No CupertinoLocalizations found" errors when opening the overflow menu by injecting localized types into the widget subtree.
• Added: Persian and Portuguese translations for player controls and menus.
• Updated: Added overflowMenuCancelLabel, overflowMenuScrimLabel, and overflowMenuScrimHint to PlayerTranslations for better localization of menu actions.
• Added: Comprehensive unit tests for localization bridge and translation factories.

1.8.1

• Updated: package metadata

1.8.0

• Added: Support for configurable DRM security level (Widevine L1/L3) via PlayerDataSource.
• Updated: Enhanced DRM documentation with details on drmSecurityLevel configuration for Android and Web.
• Added: Documentation for unit and widget testing with platform mocking.
• Updated: Clarified in documentation that customControlsBuilder requires playerTheme to be set to PlayerTheme.custom.
• Updated: Bumped dependencies for better_player_android, better_player_ios, better_player_platform_interface, and better_player_web.

1.7.0

• [BREAKING_CHANGE] Decoupled PlayerEngineController from dart:io. setFileDataSource now accepts a String filePath instead of a File object.
• Added: Web and WASM compatibility support.
• Fixed: Transitive dart:io imports that prevented web compilation.

1.6.0

• Added: Web platform support documentation, including a detailed feature matrix and setup instructions for Shaka Player.
• Updated: Moved all E2E tests (Maestro and Playwright) into a centralized e2e directory and updated all configuration and workflow paths.
• Fixed: Resolved BetterPlayerAsmsUtils, PlayerSubtitlesFactory, and BetterPlayerHlsUtils network test failures by adding injectable http.Client for testing.
• Fixed: Resolved better_player_cupertino_controls_test.dart failure by using proper widget interaction and pumping.

1.5.1

• Fixed: Resolved Cupertino action sheet fallback label and destructive styling for the cancel button, restoring proper localization and iOS consistency.
• Updated: Reworked the Cplsupertino overflow menu bottom sheet to use the native CupertinoActionSheet widget instead of the Material fallback when the theme is explicitly set to Cupertino.
• Fixed: Hardcoded Cupertino play/pause and skip icon sizes in the bottom control bar to avoid improper scaling on resizing or entering fullscreen.
• Added: Enhanced automated UI tests to explicitly verify Cupertino styling, sizes, and action sheets.

1.5.0

• Updated: Refactored BetterPlayerController by segregating internal state variables into immutable data classes (PlayerViewState, PlayerSubtitleState, PlayerTrackState, PlayerPlaybackState), improving architectural scalability.
• Updated: Refactored widget helper methods (e.g. Widget _build...()) into inline Builder patterns and proper StatelessWidget classes to strictly comply with project standards, specifically across UI controls, route builders, and example apps.
• Added: Extracted event constants into PlayerEventConstants and exported them in the main library interface for easier external subscription handling.

1.4.0

• Updated: Replaced videoPlayerController with PlayerEngineController and removed the public API.
• Added: Automated migration rules in fix_data.yaml for deprecated VideoPlayerController types.
• Fixed: Broken links and outdated dependency claims in README.md files.
• Fixed: Guarded against null or uninitialized videoPlayerValue in progress bars during drag and tap gestures.

1.3.0

• Added: Extensible logging system with PlayerLogger, featuring native-to-Dart log streaming, automatic caller/tag derivation, and comprehensive internal logs.
• Updated: Comprehensive documentation audit and modernized code examples.
• Fixed: Various test and linting issues.

1.2.0

• Updated: Migrated to a modern JNI/Swift architecture for native bridges, improving performance and reliability.
• Fixed: Improved robustness in seekTo in BetterPlayerController and VideoPlayerController to prevent crashes when called before full initialization.
• Updated: Enhanced FFI E2E tests to wait for video initialization before proceeding with method calls.
• Updated: Refactored VideoPlayerController to use event stream for initialization tracking, improving robustness and fixing race conditions during data source setup.
• Fixed: A bug in VideoPlayerController where error descriptions were not correctly assigned to the player state.

1.1.1

• Fixed: fix_data.yaml syntax error preventing downgrade analysis.
• Updated: Removed [!code focus] annotations from migration docs.

1.1.0

• Refactor: Unified model names by removing 'Better' prefix.
• Added fix_data.yaml for automated migration.

1.0.1

• Add thin examples to platform packages and decoupled example app.

1.0.0

• Updated: Refactored architecture to a federated plugin model, delegating native implementations to better_player_android and better_player_ios.
• [BREAKING_CHANGE] Replaced internal models and utilities with centralized ones from better_player_platform_interface (e.g., deleted PlayerDataSourceType, renamed BetterPlayerUtils to BetterPlayerUiUtils).
• Updated: Renamed isPictureInPictureEnabled to isPictureInPictureSupported across the platform interface and core controller.
• Fixed: Restored Picture-in-Picture logic, remote notification functionalities, and various lint/compilation issues across the codebase.

0.8.1

• Added: Semantic identifiers across player controls, UI components, and resolution selection items for robust E2E testing.
• Fixed: Race condition when launching sub-menus on iOS.
• Updated: Improved HLS quality detection.
• Updated: Refactored player controls by replacing widget helper methods with dedicated stateless widgets for improved performance and maintainability.
• Updated: Documentation regarding DRM playback.
• Updated: Excluded Node.js dependencies and documentation build artifacts from the package distribution.

0.8.0

• Added: Maestro E2E flows for iOS and integrated them into GitHub Actions.
• Updated: [BREAKING_CHANGE] Migrated iOS implementation to Swift.
• Updated: [BREAKING_CHANGE] Finalized Swift Package Manager (SPM) migration for iOS.

0.7.1

• Fixed: HLS ABR video sizing issues (small video in corner) on Android TV and other platforms by making UI components reactive to resolution changes reported by the native layer.
• Fixed: Broken image links in the documentation by updating the paths to assets/media/.
• Fixed: Audio tracks returning null immediately after data source setup by awaiting ASMS parsing and improving track state management.
• Fixed: Embedded HLS/ASMS subtitles not being rendered due to incorrect segment timing and JIT loading logic.

0.7.0

• Fixed: Improved error handling for DASH streams on iOS by providing a descriptive Dart-side exception instead of a generic native error (AVPlayer does not support DASH).
• Updated: Documentation to clarify that DASH and Smooth Streaming are currently Android-only features.
• Added: changedSize event for both Android and iOS to update player dimensions during playback, fixing the issue where video container does not resize when resolution changes dynamically.
• Fixed: DASH live streams with sliding windows jumping or looping back on Android. Improved native DASH live configuration and correctly marked example streams as live.

0.6.1

• Added: Example demonstrating auto-fullscreen on rotation using OrientationBuilder.
• Updated: Reorganized media files into assets/media/ and added assets/pub/ for pub.dev screenshots and logo.
• Fixed: Android duration sometimes reporting zero for VOD streams by handling ExoPlayer's C.TIME_UNSET value and delaying the initialized event until a valid duration is available via onTimelineChanged.
• Fixed: Video aspect ratio not scaling correctly based on the video's actual aspect ratio when no aspect ratio is configured.
• Added: Unit tests for video aspect ratio priority and duration initialization.

0.6.0

• [BREAKING_CHANGE] Updated: Changed Android package name, namespace, and bundle ID to pl.hasoft.better_player.
• Added: Comprehensive migration guides for transitioning from video_player and chewie to better_player.
• Updated: Enhanced dark mode alert colors for documentation tips and important notes.
• Updated: Added direct links to migration guides in README.md and documentation sidebar.

0.5.0

• Updated: Major architectural refactor of player controls and UI components. Helper build methods (_buildWidget()) were replaced with dedicated Flutter Widget classes for improved modularity, performance, and maintainability.
• Added: New granular widgets for Material and Cupertino controls, including top/bottom bars, hit areas, and status overlays.
• Added: Isolated component testing suite for refactored widgets to improve UI reliability and coverage.
• Updated: Applied project-wide coding standard for named parameters (required for 2+ arguments or 1 boolean argument).

0.4.3

• Updated: Comprehensive documentation overhaul for professional tone, grammar, and typos across all project documentation.
• Fixed: Documentation alert rendering by adding docsify-plugin-flexible-alerts plugin.
• Added: Advanced accessibility support with localized labels and interactive semantics for controls and progress bar.
• Fixed: Example app home page video URL.

0.4.2

• Fixed: Restricted logo size on the documentation website to prevent it from being too large.
• Updated: Replaced legacy PNG logo with a modern, concentric SVG identity across the library, documentation, and example app.
• Updated: Generated new Android and iOS launcher icons for the example app using the modern identity.
• Updated: Refactored README.md to a professional standard with categorized features and a quick start guide.

0.4.1

• Fixed: Updated example video and image URLs with stable sources.
• Fixed: Updated DRM test streams (Widevine, FairPlay, and Token-based) in the example app with stable working mirrors.
• Fixed: Localization issue by using standard MaterialApp and combining delegates from flutter_localizations and material_ui.
• Updated: External subtitles in the example app to match the video content.
• Fixed: Enable Picture-in-Picture support in the example app's AndroidManifest.xml.
• Fixed: Layout overflow issues in multiple example pages by adding scrolling support.
• Fixed: Robustness of Picture-in-Picture mode activation and deactivation on Android.

0.4.0

• [BREAKING_CHANGE] Added: Support for Built-in Kotlin.
• [BREAKING_CHANGE] Updated: Minimum Dart SDK version to 3.12.0.

0.3.0

• [BREAKING_CHANGE] Migrated to Flutter 3.47.0.
• [BREAKING_CHANGE] Migrated Material and Cupertino UI systems to standalone material_ui and cupertino_ui packages.
• Updated compileSdkVersion to 36 in Android.
• Updated Kotlin version to 2.3.20 in the example app.
• Updated Android Gradle Plugin version to 9.0.1 in the example app.

0.2.1

• Added: .pubignore to exclude media/ and AGENTS.md from the published package.
• Updated: Documentation and README links to point to the new media location on GitHub.
• Updated: README.md to remove outdated migration information.
• Fixed: prefer_if_elements_to_conditional_expressions lint warnings in Material controls.

0.2.0

• [BREAKING_CHANGE] Updated: iOS to Swift Package Manager (SPM). Native source files moved from ios/Classes to ios/better_player/Sources.
• [BREAKING_CHANGE] Updated: Android build.gradle using the plugins {} block. Removed legacy kotlin-android apply plugin.
• Updated: very_good_analysis to 10.3.0 and addressed new linting rules.
• Updated: xml dependency to 7.0.0.
• Updated: meta dependency to 1.18.0.

0.1.0

• [BREAKING_CHANGE] Updated: Android playback engine from ExoPlayer 2 to AndroidX Media3 (1.1.1).
• [BREAKING_CHANGE] Updated: minimum Flutter version to 3.22.0 and minimum Dart version to 3.4.0.
• Updated: linter to very_good_analysis (VGV).
• Updated: all core and dev dependencies.
• Updated: CI/CD workflows (GitHub Actions).
• Updated: Kotlin version to 2.2.20.
• Updated: compileSdkVersion to 34.

0.0.84

• [BREAKING_CHANGE] Updated min. Flutter version to 3.3.0 and min. Dart version to 3.0.0.
• Recreated example project.
• Replaced wakelock with wakelock plus.
• Updated other dependencies.
• Updated metadata.

0.0.83

• Updated dependencies
• Fixed Flutter 3.0 issues

0.0.82

• Updated ExoPlayer version to 2.17.1.
• Updated dependencies.
• Android native code refactor.

0.0.81

• Fixed full screen button padding in material controls.
• Added setPlayerControlsConfiguration in BetterPlayerController.
• Added setOverriddenFit in BetterPlayerController.

0.0.80

• Removed pedantic dependency.
• Updated dependencies.
• Fixed controls render issue for small player (by https://github.com/admarwick)
• Fixed deprecated jCenter. Replaced jCenter with mavenCentral (by https://github.com/petoknm)
• Fixed iOS GCDWebServer and PINCache import issue (by https://github.com/twogood)
• Added is mounted check in player controls (by https://github.com/masoudk2000)
• Updated installation documentation page.

0.0.79

• Fixed kotlin version issue.

0.0.78

• [BREAKING_CHANGE] Split controlsHidden into controlsHiddenStart and controlsHiddenEnd.
• [BREAKING_CHANGE] Added to Function(bool) onPlayerVisibilityChanged to customControlsBuilder in [PlayerConfiguration].
• Migrated android native code to Kotlin.
• Updated ExoPlayer version to 2.15.1.
• Updated screenshots.
• Added onTapDown handle for material and cupertino progress bar to handle show and hide of controls.
• Fixed crash related to Android 12.
• Fixed issue with full url of subtitle for HLS data source.
• Fixed install page from doc.
• Fixed one of the showcase images.
• Fixed video in list example.

0.0.77

• Fixed full screen safe area issue in cupertino controls.
• Fixed subtitles duplication after changing data source.
• Fixed progress bar issues when changing position of the video.
• [BREAKING_CHANGE] Changed min. Flutter version to 2.2.3.
• Changed log level in ExoPlayer to Error.
• Added url parameter for changedResolution event.
• Added [videoExtension] support for network data source for scenario where video source has no extension and cache manager requires it.
• Added parameters to [changedTrack] event.
• Added [changedPlaylistItem] event.
• Added [autoDetectFullscreenAspectRatio] parameter in [PlayerConfiguration] (by https://github.com/Brazol)
• Updated license.
• Updated screenshots.

0.0.76

• Fixed iOS build issue.
• [BREAKING_CHANGE] Changed min required iOS version to 11.
• Updated PlayerConfiguration copyWith method.
• Added useRootNavigator option to PlayerConfiguration.

0.0.75

• Fixed iOS build issue.

0.0.74

• [BREAKING_CHANGE] nextVideoTimeStreamController is now marked as private. Please use nextVideoTimeStream to access stream.
• [BREAKING_CHANGE] Removed BackdropFilter from cupertino theme.
• [BREAKING_CHANGE] Removed sigmaX and sigmaY parameters from PlayerControlsConfiguration.
• Added expandToFill in PlayerConfiguration.
• Added PlayerControlsConfiguration.theme factory for PlayerControlsConfiguration.
• Added null checks in seek commands in BetterPlayerControlsState.
• Added tests.
• Added iOS HLS caching based on HLSCachingReverseProxyServer.
• Added default subtitle support for ASMS HLS data source (by https://github.com/siloebb).
• Fixed issue with live stream where player controls were always visible.
• Fixed iOS seek issue.
• Fixed getting started button link in documentation.
• Changed iOS non-HLS caching implementation based on https://github.com/neekeetab/CachingPlayerItem (by https://github.com/themadmrj).
• Fixed hardcoded 30 FPS on iOS (by https://github.com/antonkrasov).
• Enabled preCache and stopPreCache for iOS.
• Updated dependencies.

0.0.73

• Added licenseUrl support for iOS DRM.
• Fixed RTL text direction issue in player controls.
• Added renderedSubtitle in BetterPlayerController.
• Added additional check in postControllerEvent to handle scenario where event stream is closed.
• Updated ExoPlayer version
• Fixed bufferingUpdate event triggered too often.
• Updated video list example with bufering configuration.
• Updated video list documentation.
• Added setMixWithOthers method in BetterPlayerListVideoPlayerController.
• Fixed broken link in cover page of documentation.
• Fixed progress bar issue where position could be set above video duration.
• Fixed iOS remote notification command issue.
• Removed duplicated page in example app (by https://github.com/pinguluk)
• Added support for clear key DRM (by https://github.com/tinusneethling)
• Refreshed look and feel of the player UI (by https://github.com/creativeblaq)
• Added sigmaX and sigmaY parameters in PlayerControlsConfiguration to control blur of cupertino controls (original idea by: https://github.com/YeFei572)

0.0.72

• Updated ExoPlayer version

0.0.71

• Fixed play after seeking issue on iOS.
• Fixed audio track selection issue on iOS/Android.
• Fixed issue where speed which couldn't be applied on iOS was saved in player state.
• Added support for D-pad navigation using a Android TV remote control (by https://github.com/danielz-nenda)
• Added BetterPlayerMultipleGestureDetector to handle problems with gesture detection
• Expose getter for eventListeners in BetterPlayerController (by https://github.com/Letalus)
• Updated documentation
• Updated dependencies

0.0.70

• Fixed file data source exception. Right now user will be only warned.
• Fixed playback speed after seek in iOS.
• Fixed overriddenDuration behavior in iOS when passed overriddenDuration is longer than video duration.
• Fixed issue where controls were not updated after video finish.
• Fixed auto full screen orientation not enabled in iOS.
• Exposed ASMS classes.
• Exposed BetterPlayerControlsState to provide ways to build custom controls with additional menus.
• Added error handling for CacheWorker to prevent unexpected crashes.
• Added support for FairPlay EZDRM (by https://github.com/adrianByv and https://github.com/koldo92)
• Added certificateUrl parameter in BetterPlayerDrmConfiguration.
• Added support for custom buffering configuration in Android (by https://github.com/Letalus)
• Added bufferingConfiguration parameter in PlayerConfiguration which contains buffering settings.

0.0.69

• Fixed cache clear on Android.
• Added file check for file data source.
• Fixed issue with black screen for some videos on iOS (by https://github.com/themadmrj)
• Fixed iOS eventSink issues. (by https://github.com/alextekartik)
• Added key parameter in BetterPlayerCacheConfiguration to provide way to re-use same video between app sessions.

0.0.68

• Added support for segmented subtitles.
• Added new fields in in PlayerSubtitlesSource: asmsIsSegmented, asmsSegmentsTime and asmsSegments. These fields shouldn't be configured manually.
• Fixed parsing VTT subtitle timestamps with no hour component (by https://github.com/trms-alex).
• Fixed parsing VTT subtitles when there's no subtitles in the file (by https://github.com/trms-alex).
• Added ES translations (by https://github.com/koldo92).
• Fixed iOS Picture in Picture play/pause state.
• Updated dependencies.
• Updated iOS example configuration.

0.0.67

• Added support for DASH adaptive stream subtitles, audio tracks, tracks (by https://github.com/adrianByv)
• [BREAKING_CHANGE] Changed useHlsSubtitles, useHlsTracks, useHlsAudio to useAsmsSubtitles, useAsmsTracks, useAsmsAudio.
• Added DASH example.
• Fixed progress bar jumps when seeking video.
• Fixed end of video looping final second, and video stutter during AudioSession deactivation (by https://github.com/NicholasNagy)

0.0.66

• Added check in seek method to handle scenario when video wasn't ready to play.
• Added setupDataSourceList in BetterPlayerPlaylistController.
• Fixed playback stalled issue in iOS.
• Added pause on iOS dispose call.
• Added bufferedStart, bufferedUpdate, bufferedEnd events.
• Fixed full screen dismissed when new data source loaded.
• Added forget option for VisibilityDetectorController (by https://github.com/ChopinDavid).
• Added vietnamese translations (by https://github.com/thanhvn-57).

0.0.65

• Refactored Android notification image selection.
• Added headers parameter in PlayerSubtitlesSource. Headers is an optional parameter.
• Added activityName to BetterPlayerNotificationConfiguration.
• Android notification will open back application (by https://github.com/shashikantdurge).
• Fixed playing audio-only resources in iOS.
• Updated Exo Player version.
• Fixed notification not updating correctly for playlists in Android.
• [BREAKING_CHANGE] Removed deprecated Android code. Better Player supports now only v2 embedding.

0.0.64

• Added Turkish translations (by https://github.com/smurat).
• Video fit fixes (by https://github.com/themadmrj).
• Fixed speed iOS issue.
• Fixed Android's notification image OOM issue.
• Fixed 0 second delay issue in playlist.
• Fixed drmHeaders to be sent in headers rather than request body (by https://github.com/FlutterSu)
• Added preCache, stopPreCache method in BetterPlayerController (coauthored with: https://github.com/themadmrj)
• [BREAKING_CHANGE] clearCache method doesn't require to setup data source in order to use.

0.0.63

• Fixed pause method in dispose.
• Added clearCache method in BetterPlayerController.
• Fixed reusable video player example issues.

0.0.62

• Refactored internal event handling.
• [BREAKING_CHANGE] Migrated to null safety.
• [BREAKING_CHANGE] Updated dart min version to 2.12.0.
• Fixed issue where player controls were immediately hidden.
• Removed cancelFullScreenDismiss parameter.
• Added initialization check for VideoPlayerController.
• Changed default value of enableProgressText to true in PlayerControlsConfiguration.
• Setup first selected HLS Audio as default one.
• General bug fixes.

0.0.61

• Fixed fullscreenByDefault issue.
• Updated documentation.

0.0.60

• Updated documentation.
• Added null checking for videoPlayerController inside BetterPlayerController.
• Added setMixWithOthers method to BetterPlayerController.
• Added initialStartIndex in PlayerPlaylistConfiguration.
• Fixed issue where player did not disposed properly on app quit.
• Added placeholder parameter in PlayerDataSource.
• Fixed custom material full screen icons (by https://github.com/FelipeFernandesLeandro)

0.0.59

• Fixed WEBVTT subtitles parsing.
• Updated ExoPlayer version.
• Refactored ExoPlayer code.
• Added missing controller dispose from BetterPlayer widget dispose.
• Added fix for iOS aspect ratio issue.
• Fixed auto play issue where player starts video after load initialization process and player is not visible.
• Updated texts in examples.
• Added missing widevine DRM parameters (by https://github.com/FlutterSu).

0.0.58

• Added overflowModalColor and overflowModalTextColor in PlayerControlsConfiguration.
• Disabled picture in picture in fullscreen mode.
• Fixed enabled parameter for skip back and forward.
• Fixed notification configuration null issue (by https://github.com/bounty1342)
• Added token based and widevine DRM support.
• Updated documentation.

0.0.57

• Fixed iOS HLS initialization issue.
• Fixed issue where video plays after resume even if it's not visible.
• Updated User-Agent picking for Android.
• Added auto option for quality selection.

0.0.56

• Fixed empty data source notification issue.
• Fixed WebVTT subtitles parsing issue.
• Fixed memory data source issue on iOS.
• Added videoExtension parameter for memory data source (works only with memory data source).
• Added videoFormat parameter to network data source.
• Fixed controls visible all time on live stream.
• Fixed potential iOS notification crash.

0.0.55

• Dart analysis fix

0.0.54

• Refactored BetterPlayerPlaylist feature.
• Added new BetterPlayerPlaylistController which is accessible from BetterPlayerPlaylist's current state. Playlist video can be changed with setupDataSource method and current video index can be accessed with currentDataSourceIndex getter.
• Fixed iOS availableDuration index issue.
• Added arabic translations (by https://github.com/mohamed-Etman).
• Added headers to HLS data request (by https://github.com/mohamed-Etman).
• Added fullScreenAspectRatio to copyWith method in PlayerConfiguration (by https://github.com/njlawton)

0.0.53

• Fixed fullscreen issue.
• Fixed HLS tracks selection.
• Removed HLS parser package and included HLS parser package in Better Player.
• Removed unused player observer in iOS.
• Fixed cache issue in Android where multiple Better Player instances uses same directory.
• Fixed HLS parsing issue.
• Added HLS Audio example.

0.0.52

• Fixed unregister listener issue in iOS.
• Updated documentation.
• [BREAKING_CHANGE] BetterPlayerState visibility changed to private.
• Fixed HLS audio tracks playlist selection issue.
• Added enableProgressBarDrag in PlayerControlsConfiguration.
• Fixed audio track picking in ExoPlayer (Android).
• Changed default loadingColor.

0.0.51

• Fixed lint issues.
• Fixed subtitles setup issue.

0.0.50

• Fixed deprecated resizeToAvoidBottomPadding
• Fixed playing large videos in iOS.
• [BREAKING_CHANGE] Removed autoPlay and errorBuilder from BetterPlayerController. These can be accessed via betterPlayerController.
• Added HLS Audio track support.
• Added setAudioTrack method in BetterPlayerController.
• Added useHlsAudioTrack parameter in PlayerDataSource.
• Added enableAudioTracks and audioTracksIcon, backgroundColor in PlayerControlsConfiguration.
• Fixed HLS loading speed.
• Fixed finished event creation.
• Fixed player pause issue when player notification is displayed.
• Fixed player not pausing/resuming automatically correctly.

0.0.49

• Fixed fullscreen dispose issue.
• Added videoFormat parameter in PlayerDataSource (should be used when data source url has no extension).
• Added retry feature after video failed to load.
• Added enableRetry in PlayerControlsConfiguration.
• Changed PlayerEventType.openFullscreen and PlayerEventType.hideFullscreen events behavior (now events trigger after route change).
• Removed closed caption support from original video_player codebase.
• Fixed chinese translation typo (fixed by https://github.com/Big7lion)

0.0.48

• Fixed loading large videos in iOS.
• Fixed partly progress bar jumping when seek issue in iOS.
• Added forceDispose parameter to dispose method in BetterPlayerController.
• Fixed Android notification vibration issue (fixed by https://github.com/marcusforsberg).

0.0.47

• Fixed Android loading indicator issue.
• Added setControlsAlwaysVisible in BetterPlayerController.
• Added absolutePosition feature (added by https://github.com/FlutterSu)

0.0.46

• Fixed iOS AVPlayer observer issue.
• Fixed iOS headers not applied issue.

0.0.45

• Added Picture in Picture support.
• Added new parameters in PlayerControlsConfiguration: pipMenuIcon and enablePip.
• Added new methods in BetterPlayerController: enablePictureInPicture, disablePictureInPicture, isPictureInPictureSupported, setBetterPlayerGlobalKey.
• Added Picture in Picture icon in player controls.
• Added Picture in Picture example.
• Updated ExoPlayer version.
• Added pipStart and pipStop events.
• [BREAKING_CHANGE] Removed skipsTimeInMilliseconds. Added forwardSkipTimeInMilliseconds and backwardSkipTimeInMilliseconds.
• Updated notification service in android example.
• Fixed event play/pause event not triggered when controlling video with PiP or remote notification.
• Fixed playerTheme not set correctly.
• Fixed progress bar able to drag over other buttons.
• Fixed iOS player last second issue (player did not complete on last second of resource).

0.0.44

• Added placeholder until play example
• Added playback stalled feature in iOS. iOS version should behave same as Android once video failed to load.
• Added PlayerTheme to controls configuration (added by https://github.com/maine98).
• [BREAKING_CHANGE] Changed custom controls builder in PlayerControlsConfiguration. Now it accepts BetterPlayerController.
• Exposed BetterPlayerPlaylistState and betterPlayerController getter within.
• Added overriddenDuration to PlayerDataSource.

0.0.43

• Added autoDispose flag in PlayerConfiguration
• Added removeEventsListener in BetterPlayerController
• Video list examples update
• Fixed Android native build warnings
• Fixed placeholder until play issues
• Added placeholderOnTop to the PlayerConfiguration
• Lint fixes

0.0.42

• Fixed resolution issue
• Fixed type of PlayerDataSource for file type
• Added audio notify on dispose (iOS) (fixed by https://github.com/kingiol)

0.0.41

• Fixed loadingColor and loadingWidget for cupertino player
• Increased size of cupertino buttons
• Fixed setControlsEnabled in cupertino/material player
• [BREAKING_CHANGE] Removed startAt, looping, placeholder, overlay, fullScreenByDefault, allowedScreenSleep, systemOverlaysAfterFullScreen, deviceOrientationsAfterFullScreen from BetterPlayerController

0.0.40

• Exposed VideoPlayerValue in export
• Fixed log issue
• Added loadingColor and loadingWidget in PlayerControlsConfiguration

0.0.39

• Added lint library for dart analysis
• [BREAKING_CHANGE] Changed constant names to lowerCamelCase in PlayerDataSourceType
• [BREAKING_CHANGE] Changed constant names to lowerCamelCase in PlayerEventType
• [BREAKING_CHANGE] Changed constant names to lowerCamelCase in PlayerSubtitlesSourceType

0.0.38

• Added support for player notifications
• Added handleLifecycle to PlayerConfiguration
• Added notificationConfiguration to PlayerDataSource

0.0.37

• Added setControlsEnabled to BetterPlayerController
• Fixed example video list widget buttons not rendering correctly in small resolutions
• Added setOverriddenAspectRatio to BetterPlayerController
• Fixed crash connected with setSpeed in Android platform
• Fixed deviceOrientationsOnFullScreen for iOS
• Fixed CH translations (fixes by https://github.com/JarvanMo)
• Click to show/hide controls (fixed by https://github.com/mtAlves)
• [BREAKING_CHANGE] Removed future from isPlaying. Now it's sync method (https://github.com/hongfeiyang)

0.0.36

• Added INITIALIZED event
• Added autoDetectFullscreenDeviceOrientation in PlayerConfiguration
• Fixed autoPlay background issue
• Removed open_iconic_flutter icons used in Cupertino controls
• Added cupertino_icons for icons used Cupertiono controls
• Fixed progress bar not working correctly for iOS 12 with file datasource
• Removed yellow line below progress text (fixed by https://github.com/mtAlves)

0.0.35

• Fixed iOS black screen issue
• Fixed full screen placeholder issue
• Fixed event not firing in enterFullScreen and exitFullScreen
• Fixed subtitles parsing issues

0.0.34

• Added memory data source
• Added factories: network, file, memory for PlayerDataSource
• Fixed missing useHlsTracks implementation
• Fixed placeholder showing after full screen when using showPlaceholderUntilPlay
• Added setControlsVisibility to BetterPlayerController
• [BREAKING_CHANGE] Removed showControlsOnInitialize from PlayerConfiguration. Use PlayerControlsConfiguration to set showControlsOnInitialize parameter.
• Fixed cupertino controls issue with hasError

0.0.33

• Fixed PlayerEvent visibility
• Fixed lazy initialization, when first data source is passed after player finishes first render
• Added selectedByDefault to PlayerSubtitlesConfiguration
• Fixed HLS tracks android native code
• Updated example

0.0.32

• Fixed locale picking when context is not mounted anymore
• Added cache feature (based on https://github.com/sanekyy/plugins/tree/caching and https://github.com/vikram25897/flutter_cached_video_player solutions)
• Added BetterPlayerCacheConfiguration to PlayerDataSource
• Refactored Android's native code

0.0.31

• Added showPlaceholderUntilPlay in PlayerConfiguration
• Fixed exception event not being triggered
• Fixed controls not displaying on video finished

0.0.30

• Fixed issue when full screen was triggered twice if autoPlay and fullScreenByDefault were enabled
• Removed flutter_widgets, since it's not maintained anymore. Added instead visibility_detector package (by https://github.com/espresso3389)
• Added rewind and forward buttons for android player.
• Fixed player UI's jank
• Added enableSkips and skipsTimeInMilliseconds in PlayerControlsConfiguration
• Changed middle play button behavior (now it's only used for restart player).
• Updated BetterPlayerControllerProvider visibility.
• Override invalid dependency from wakelock library.

0.0.29+1

• Updated readme

0.0.29

• Fixed routePageBuilder usage from PlayerConfiguration
• Added overflowMenuIcon, playbackSpeedIcon, qualitiesIcon, subtitlesIcon, overflowMenuIconsColor to PlayerControlsConfiguration
• Added double tap to play/pause video (original idea by https://github.com/r6c)

0.0.28

• Fixed subtitles overflow issue when transitioning between fullscreen and normal state
• Added alignment and backgroundColor in PlayerSubtitlesConfiguration

0.0.27

• Added enableOverflowMenu option in PlayerControlsConfiguration (enable/disable overflow menu)
• Added overflowMenuCustomItems in PlayerControlsConfiguration (show custom menu items in overflow menu)
• [BREAKING_CHANGE] Removed defaultErrorText, loadingNextVideoText, liveText from PlayerControlsConfiguration. To change these values, please use translations in PlayerConfiguration.
• Added PlayerTranslations in PlayerConfiguration. You can use it to setup translations of the player.

0.0.26

• Added fullScreenAspectRatio and deviceOrientationsOnFullScreen to handle different full screen scenarios
• Updated wakelock version

0.0.25

• [BREAKING_CHANGE]: changed API in PlayerControlsConfiguration: enableQualities replaces enableTracks.
• Added support for different video resolutions
• Fixed issue when full screen is being dismissed on changing subtitles
• Added CHANGED_RESOLUTION event

0.0.24

• Added possibility to set multiple subtitles to video
• [BREAKING_CHANGE]: changed API in PlayerDataSource. Instead of one subtitles object, list of subtitles is required.

0.0.23

• General bug fixes.
• Added player visibility changed behavior in PlayerConfiguration.
• Changed player behavior when player is not visible in viewport: if player was playing before leaving viewport it will be paused and if user views player again it will start playing automatically.
• Added BetterPlayer.network and BetterPlayer.file methods.
• Changed iOS & Android native classes name to prevent conflict issues with video_player.

0.0.22

• Added support for hls tracks (quality of the videos).
• Added useHlsTracks and hlsTrackName in PlayerDataSource.
• Added CHANGED_TRACK event.
• You can choose track from overflow menu. When there's no tracks to select "Default" will be selected.

0.0.21

• Added enableSubtitles parameter.

0.0.20

• Added rotation parameter in PlayerConfiguration.

0.0.19

• Added support for hls subtitles (BetterPlayer will handle them automatically).
• [BREAKING_CHANGE]: changed API in PlayerSubtitlesSource. To use old API, please use factory: PlayerSubtitlesSource.single.
• Added useHlsSubtitles parameter in PlayerDataSource.
• Added CHANGED_SUBTITLES event.
• User can choose subtitles from overflow menu, when there's no subtitles selected, "none" options will be chosen.

0.0.18:

• Fixed loading issue when auto play video feature is enabled in playlist.

0.0.17

• Fixed placeholder not following video fit options (fixed by https://github.com/nicholascioli).
• Updated dependencies.

0.0.16

• Added overflow menu.
• Added playback speed feature (based on https://github.com/shiyiya solution).
• User can choose playback speed from overflow menu.
• Added SET_SPEED event.

0.0.15

• Added fit configuration option (based on https://github.com/shiyiya solution).

0.0.14

• Better player list video player state is preserved on state changed.
• Fixed manual dispose issue.
• Fixed playlists video changing issue (fixed by https://github.com/sokolovstas).
• Added tap to hide feature for iOS player (by https://github.com/gazialankus).
• Fixed CONTROLS_VISIBLE and CONTROLS_HIDDEN events not triggered for ios player (fixed by https://github.com/gazialankus).
• Added seek method to BetterPlayerListVideoPlayerController.

0.0.13

• Changed channel name of video player plugin.
• Fixed dispose issue in cupertino player.

0.0.12

• Fixed duration called on null (fixed by https://github.com/ganeshrvel).
• Added new control events (fixed by https://github.com/ganeshrvel).
• Fixed .m3u8 live stream issues in iOS.

0.0.11

• Fixed iOS crash on dispose.
• Added player headers support.
• Updated dependencies.
• Dart Analysis refactor.

0.0.10

• Added BetterPlayerListVideoPlayerController to control list video player.

0.0.9

• Fixed setState called after dispose.
• General bugfixes.

0.0.8

• Fixed buffering indicator issue on Android.

0.0.7

• Fixed progress bar scroll lag.

0.0.6

• Fixed video duration issue.
• Added HTML subtitles.

0.0.5

• Added reusable video player.
• Bug fixes.

0.0.4

• Changed 'settings' to 'configuration'.
• Removed unused parameters from configuration.
• Documentation update.

0.0.3

• Updated documentation.

0.0.2

• Moved example project from example to example.

0.0.1

• Initial release.