omni_video_player

✨ New Features

• Added scrubbing thumbnail preview in the video player UI.

  • Introduced a new showScrubbingThumbnailPreview parameter in PlayerUIVisibilityOptions.
  • This parameter allows developers to enable or disable the small preview thumbnail that appears when dragging the seek bar.
  • Default value is true, ensuring the preview is shown unless explicitly turned off.

⬆️ Updates dependencies

• Updated all dependencies.

⬆️ Updates dependencies · Improvement

• Updated all dependencies.
• Improved YouTube WebView player and removed all YouTube branding.

⚡ Replaced video_player with media_kit · Faster playback

• Replaced the underlying video_player package with media_kit for native video playback.
• Significantly faster video loading on iOS and Android.
• Resolves the iOS video_player issue of preloading the entire video (see flutter/flutter#126760).
• Improved support for multiple resolutions.
• Note: Audio does not work on the iOS Simulator, works on real devices and android Simulator.

🛠 Fix

• Fixed orientation and fullscreen exit issues on Android and iOS.

  • App no longer remains stuck in landscape mode after closing fullscreen.
  • See issue: #9

🛠 Fix

• Fixed autoplay not working issue on Web.
  • See issue: #46
• Removed white border appearing on top and left sides in Web player.
  • See issue: #47

🛠 Bug Fixes · Renaming · Code Refactor

• Fixed several minor bugs improving playback stability and UI consistency.
• Thanks to @Md-Sifatullah617 for contributing a fix to one of the issues. 🙌
• The parameter options in OmniVideoPlayer has been renamed to configuration for clarity.

⬆️ Updates dependencies

🛠 Refactor / Improvement

• Reduced reliance on external libraries (from 5 libraries for web view management) and refactored to use the new flutter_inappwebview dependency.

✨ New Features

• Enhanced accessibility throughout the OmniVideoPlayer.

  • The video player has been made fully accessible, ensuring it can be properly used by visually impaired users.
  • Introduced a new VideoPlayerAccessibilityTheme parameter in OmniVideoPlayerThemeData, allowing developers to customize semantic labels and accessibility messages for all player controls and overlays.

🛠 Fix

• Fixed YouTube WebView playback issue
  • See issue: #37

🛠 Fix

• Improved video startup performance for long videos on iOS.
  • See issue: #37
  • See issue: #40

🛠 Fix

• Fixed issue with exiting fullscreen in release mode.
  • See issue: #38

🛠 Fix

• Fixed several minor issues in the player related to video controller management and playback of certain network sources.
• Removed the refreshOnUrlReuse parameter, which is no longer valid and no longer used by the player.

✨ New Features

• Added refreshOnUrlReuse parameter to VideoSourceConfiguration.network.

  • When set to true, the player will always create a new controller even if a controller for the same videoUrl already exists in cache.
  • This is particularly useful when working with temporary or expiring network URLs (e.g., signed or tokenized URLs) that may return HTTP 400/403 errors if reused.
  • Default: false

🛠 Fix

• Fixed minor playback issues
• Removed a package dependency to reduce overall bundle size.
• Added automatic retry logic when entering an error state — the player now retries initialization up to 3 times before failing definitively.

✨ New Features

• Added showBottomControlsBarOnPause parameter to PlayerUIVisibilityOptions.

  • When set to true, the bottom control bar remains visible while the video is paused, providing easier access to playback controls during pause state.
  • Default: false

✨ New Features

• Added alwaysShowBottomControlsBar parameter to PlayerUIVisibilityOptions.

  • When set to true, the bottom control bar is always visible, even when the video is paused or hasn't started yet.
  • Default: false

🛠 Refactor / Improvement

• Added a singleton VideoPlaybackControllerPool to reuse VideoPlaybackController instances.

  • Reuses the existing controller if the requested URI is the same and already initialized.
  • Disposes and recreates the controller only when switching to a new URI or after an initialization failure.
  • Simplifies controller management and reduces unnecessary decoder creation, improving performance and memory usage.

🛠 Fix

• Added automatic retry for VideoPlaybackController initialization.

  • Retries up to 3 times with 250 ms delay between attempts to prevent intermittent OMX.qcom.video.decoder.avc (NO_MEMORY) crashes on some Android devices when switching videos rapidly.

✨ New Features

• Added keepAlive parameter to VideoSourceConfiguration.

  • When set to true, the video controller is not automatically disposed, allowing the video state to persist between rebuilds or navigation changes.
  • Default: false
  • ⚠️ Use with caution — if you never call dispose() manually, this may cause memory leaks or OutOfMemory errors.

🛠 Fix

• Fixed occasional OMX.qcom.video.decoder.avc (NO_MEMORY) crash on Android.

  • Set mixWithOthers to false in VideoPlaybackController to prevent hardware decoder conflicts when multiple players or audio sessions are active.

🛠 Fix / UI

• Fixed ProgressBar crash in fullscreen.

  • Prevents invalid clamp arguments when video starts or panel layouts reduce available width.

🧹 Removals

• Removed unused parameters in VideoPlayerLabelTheme:
  • openExternalLabel
  • refreshLabel
• These labels were not used anywhere in the player and have been removed to simplify the API.

✨ New Features

• Fullscreen wrapper support via CustomPlayerWidgets.fullscreenWrapper.

  • Allows wrapping the entire fullscreen player with a custom widget or layout.

🛠 Fix

• Dart formatter

💥 Breaking Changes

• Removed global playback control system (GlobalPlaybackControlSettings and GlobalPlaybackController usage). App initialization is now simplified — no BlocProvider needed.

• Removed parameters from PlayerUIVisibilityOptions: showRefreshButtonInErrorPlaceholder, showOpenExternallyInErrorPlaceholder.

• VideoPlayerErrorPlaceholder simplified — now displays only the themed error icon and message. If you want to keep using the previous version, you can pass it through CustomPlayerWidgets.errorPlaceholder. The old implementation is available here: Old Video Player Error Placeholder.

• synchronizeMuteAcrossPlayers moved to VideoSourceConfiguration.

➡️ For migration details, see MIGRATION_GUIDE.md

🧩 Package Simplification

• Removed dependencies: flutter_bloc, android_intent_plus, url_launcher, built_collection.

✨ New Features

• Device volume support via volume_controller.

  • GlobalPlaybackController now listens to hardware volume changes.
  • Automatically updates mute/unmute state based on system volume.
  • No separate listener widget needed — single BlocProvider<GlobalPlaybackController> is enough.

🛠 Fix

• Update exports

🛠 Fix

• Fix issue with error into initializer

✨ New Features

• Add showOpenExternallyInErrorPlaceholder option to PlayerUIVisibilityOptions

  • When set to true, displays a “Open Externally” button inside the error placeholder if video playback fails.
  • Defaults to true.
  • Enables users to open the video in an external app or browser when the player encounters an error.