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.

The project is updated regularly, and the community around it continues to grow, so you can expect more improvements and releases over time.

💡 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 #

| 🚀 Quick Start

Installation #

Add to your pubspec.yaml:

dependencies:
  better_player_enhanced: ^1.0.4

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 #

• Getting Started
• Basic Player Usage
• List Player
• Playlist Player
• Configuration Guide
• Subtitles Setup
• DRM Implementation
• Caching Strategy
• PiP Setup

🤝 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
• Regular Releases: The package is updated regularly as the community grows and new fixes land
• 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 #

🔐 Security & DRM #

💾 Advanced Caching #

📱 Mobile Experience #

🎛️ Developer Features #

📊 Comparison with Other Players #

Documentation #

• Official documentation
• Example application
• API reference

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!