Better Player Enhanced 🎬 #

🎯 The Most Advanced Flutter Video Player #

Better Player Enhanced is a production-ready, feature-rich video player for Flutter applications. Built upon the foundation of the original Better Player by jhomlala, this enhanced version brings critical updates, modern architecture, and enterprise-grade features.

💡 Why Choose Better Player Enhanced?
This is the actively maintained fork that keeps your app compatible with the latest Flutter versions and Android ecosystem changes, while preserving all the powerful features you love.

✨ What's New in Enhanced Version #

🔥 Latest Updates #

✅ AndroidX Media3 Migration - Upgraded from deprecated ExoPlayer2 to Google's latest Media3 (1.5.0)
✅ Flutter 3.27+ Compatible - Fixed deprecated hashValues → Object.hash
✅ Modern Android Build - AGP 8.6.0, Kotlin 2.1.0, Gradle 8.9.0
✅ Improved Stability - Fixed Jetifier warnings and build compatibility issues
✅ Active Maintenance - Regular updates to keep pace with Flutter ecosystem

🙏 Credits & Acknowledgments #

Original Creator: jhomlala
This package builds upon the excellent foundation created by jhomlala. All credit for the original architecture, design, and feature set goes to the original author. We're committed to maintaining and enhancing this package while honoring the original vision.

🚀 Why Better Player Enhanced? #

The Problem with Other Video Players #

Most Flutter video players are either:

📦 Too Basic - Missing essential features for production apps
🐛 Unmaintained - Breaking with new Flutter releases
🔧 Hard to Customize - Limited configuration options
📱 Platform-Specific Issues - Poor Android/iOS parity

The Better Player Enhanced Solution #

Built on the proven Chewie foundation and enhanced far beyond, this plugin solves real-world video playback challenges with enterprise-grade features.

🎯 Feature Highlights #

🎬 Core Playback Features #

Feature	Description
🎥 Multiple Format Support	HLS, DASH, MP4, and more

| 🚀 Quick Start

Installation #

Add to your pubspec.yaml:

dependencies:
  better_player_enhanced: ^1.0.0

Basic Usage #

import 'package:better_player_enhanced/better_player.dart';

// Simple video player
BetterPlayerController controller = BetterPlayerController(
  BetterPlayerConfiguration(),
);

@override
Widget build(BuildContext context) {
  return BetterPlayer(
    controller: controller,
    betterPlayerDataSource: BetterPlayerDataSource(
      BetterPlayerDataSourceType.network,
      "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
    ),
  );
}

Advanced Example with All Features #

BetterPlayerController controller = BetterPlayerController(
  BetterPlayerConfiguration(
    autoPlay: true,
    looping: false,
    fullScreenByDefault: false,
    aspectRatio: 16 / 9,
    // Subtitle configuration
    subtitlesConfiguration: BetterPlayerSubtitlesConfiguration(
      fontSize: 20,
      fontColor: Colors.white,
    ),
    // Control bar configuration
    controlsConfiguration: BetterPlayerControlsConfiguration(
      enablePlayPause: true,
      enableMute: true,
      enableFullscreen: true,
      enableProgressBar: true,
      enableSubtitles: true,
    ),
  ),
);

BetterPlayerDataSource dataSource = BetterPlayerDataSource(
  BetterPlayerDataSourceType.network,
  "https://your-video-url.com/video.m3u8",
  // HTTP Headers
  headers: {"Custom-Header": "value"},
  // Subtitles
  subtitles: [
    BetterPlayerSubtitlesSource(
      type: BetterPlayerSubtitlesSourceType.network,
      name: "English",
      urls: ["https://example.com/subtitles_en.srt"],
    ),
    BetterPlayerSubtitlesSource(
      type: BetterPlayerSubtitlesSourceType.network,
      name: "Spanish",
      urls: ["https://example.com/subtitles_es.srt"],
    ),
  ],
  // Caching
  useAsmsCache: true,
  cacheConfiguration: BetterPlayerCacheConfiguration(
    maxCacheSize: 100 * 1024 * 1024, // 100MB
    maxCacheFileSize: 50 * 1024 * 1024, // 50MB
  ),
  // DRM
  drmConfiguration: BetterPlayerDrmConfiguration(
    drmType: BetterPlayerDrmType.widevine,
    licenseUrl: "https://your-license-server.com",
  ),
  // Notifications
  notificationConfiguration: BetterPlayerNotificationConfiguration(
    showNotification: true,
    title: "My Video Title",
    author: "Author Name",
  ),
);

controller.setupDataSource(dataSource);

📚 Documentation & Resources #

📖 Learn More #

Official Documentation - Comprehensive guides and tutorials
API Reference - Complete API documentation
Example Application - 15+ working examples

🎓 Detailed Guides #

🤝 Contributing #

We welcome contributions! Whether it's:

🐛 Bug fixes
✨ New features
📝 Documentation improvements
🧪 Test coverage

Please feel free to submit pull requests. For major changes, please open an issue first to discuss what you would like to change.

Development Setup #

# Clone the repository
git clone https://github.com/yourusername/better_player_enhanced.git

# Install dependencies
flutter pub get

# Run example app
cd example
flutter run

📄 License #

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🙋 Support #

📧 Issues: GitHub Issues
💬 Discussions: GitHub Discussions
⭐ Star: If this project helped you, please give it a star!

🔄 Migration from Original Better Player #

Switching from better_player to better_player_enhanced is seamless:

# Before
dependencies:
  better_player: ^0.0.83

# After
dependencies:
  better_player_enhanced: ^1.0.0

No code changes required! All APIs remain compatible.

⚠️ Important Notes #

Active Development: This package is actively maintained and updated
Breaking Changes: Minor versions may include breaking changes - always check the changelog
Platform Support: Android 21+, iOS 11+
Flutter Version: Requires Flutter 3.0.0 or higher

🌟 Show Your Support #

If Better Player Enhanced makes your video playback easier, please:

⭐ Star this repository
🐦 Share with the Flutter community
💖 Consider sponsoring the project
🔗 Link back to this repo in your app

Made with ❤️ by the Flutter community
_{Building upon the excellent work of jhomlala}

🎵 Audio & Video Tracks #

Feature	Description
🔊 Multi-Audio Support	Select from multiple audio tracks
🎬 Quality Selection	Switch between different video quality levels
📊 HLS Track Selection	Full control over HLS variant streams
🎚️ DASH Adaptation	Dynamic adaptive streaming over HTTP

🔐 Security & DRM #

Feature	Description
🔒 Widevine DRM	Android DRM support
🍎 FairPlay DRM	iOS DRM support via EZDRM
🎫 Token Authentication	Custom token-based DRM
🔑 ClearKey Support	Open standard DRM solution
🌐 HTTP Headers	Custom headers for authenticated requests

💾 Advanced Caching #

Feature	Description
📦 Smart Caching	Intelligent video caching system
⚙️ Configurable Size	Set max cache size and file limits
🗂️ Cache Management	Programmatic cache control
🚀 Offline Playback	Pre-cache for offline viewing

📱 Mobile Experience #

Feature	Description
📺 Picture-in-Picture	Android & iOS PiP support
🔔 Media Notifications	System-level playback controls
📋 ListView Support	Optimized for scrollable video lists
🎯 Auto-Start/Stop	Visibility-based playback control
🔄 Orientation Handling	Seamless rotation support
🎨 Custom UI	Build your own controls from scratch

🎛️ Developer Features #

Feature	Description
📊 Event System	Rich event callbacks (play, pause, error, etc.)
🐛 Error Handling	Comprehensive error reporting
⚙️ Configuration API	Fine-grained control over all aspects
🔧 Debug Options	Built-in debugging capabilities
📖 Well Documented	Extensive documentation and examples

📊 Comparison with Other Players #

Feature	Better Player Enhanced	video_player	chewie	flick_video_player
HLS Support	✅	✅	✅	✅
DASH Support	✅	❌	❌	❌
DRM Support	✅	❌	❌	❌
Subtitles (Advanced)	✅	❌	⚠️	⚠️
Caching	✅	❌	❌	❌
Notifications	✅	❌	❌	❌
Picture-in-Picture	✅	❌	⚠️	❌
Playlist	✅	❌	❌	❌
ListView Support	✅	❌	⚠️	⚠️
Active Maintenance	✅	✅	❌	❌
AndroidX Media3	✅	❌	❌	❌

Documentation #

Important information #

This plugin development is in progress. You may encounter breaking changes each version. This plugin is developed part-time for free. If you need some feature which is supported by other players available in pub dev, then feel free to create PR. All valuable contributions are welcome!

better_player_enhanced 1.0.1 better_player_enhanced: ^1.0.1 copied to clipboard

Metadata