Better Player #

Better Player handles the complex video playback edge cases so you don't have to. Originally based on video_player, it's now fully independent. It tackles HLS, DRM, and caching out of the box.

[IMPORTANT] Migrating from 0.0.84 to 1.x.x? See the Migration Guides section below.

📱 Visual Showcase #

Default Controls	Settings Menu	Audio Tracks	Event Listener

🏆 vs Competitors #

Why choose Better Player? Here is how it stacks up against the alternatives.

🚀 Key Features #

• Adaptive Streaming: Play HLS, DASH, and Smooth Streaming with automatic track selection.
• DRM Support: Protect your content with Widevine, FairPlay, and ClearKey.
• Smart Caching: Cache videos for seamless offline playback.
• Picture in Picture (PiP): Keep videos playing while users multitask.
• Advanced Subtitles: Parse SRT and WebVTT, including HTML tags.

📦 Quick Start #

1. Add dependency #

Add Better Player to your pubspec.yaml:

dependencies:
  better_player: ^1.10.0

2. Basic Usage #

Use the network factory to get a player up and running fast.

import 'package:better_player/better_player.dart';

// Inside your build method
AspectRatio(
  aspectRatio: 16 / 9,
  child: BetterPlayer.network(
    "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
    betterPlayerConfiguration: PlayerConfiguration(
      aspectRatio: 16 / 9,
      looping: true,
      autoPlay: true,
    ),
  ),
)

3. Advanced Controller Usage #

Need full control? Initialize a BetterPlayerController manually.

BetterPlayerController _controller = BetterPlayerController(
    const PlayerConfiguration(),
    betterPlayerDataSource: PlayerDataSource(
        DataSourceType.network,
        "https://example.com/video.mp4",
    ),
);

BetterPlayer(controller: _controller)

🤖 AI Agent Quick Reference #

Writing a script or prompt? Feed this to your AI to get the right code on the first try.

• Initialization: Always initialize BetterPlayerController in initState() with a PlayerConfiguration and PlayerDataSource.
• Core Classes:
  • BetterPlayerController: Manages state and configuration.
  • PlayerDataSource: Wraps video URL, DRM config, subtitles, headers.
  • PlayerConfiguration: UI, looping, autoPlay, aspect ratio.
  • PlayerControlsConfiguration: Colors, icons, padding for the control bar.
• Subtitles: Pass PlayerSubtitlesSource directly into PlayerDataSource.
• Disposal: Default is autoDispose: true. Avoid manual controller.dispose() unless you opt out.

🔄 Migration Guides #

Moving from another package? Follow these guides:

• Migrating from video_player
• Migrating from chewie
• Migrating from 0.0.84 to 1.x.x

📖 Resources #

• Official Documentation
• Example Application
• API Reference

🤝 Contributing #

Bugs? Feature requests? Open an issue. Better yet, submit a PR.

💼 Enterprise Support #

Need a custom video source adapter, bespoke DRM implementation, or tailored UI controls? I'm available for consulting.

Let's talk on LinkedIn →