betterplayer

<p align="center">
  <img src="https://raw.githubusercontent.com/jhomlala/betterplayer/master/assets/media/logo.png" width="220px" alt="Better Player Logo">
</p>

# Better Player

<p align="center">
  <b>The complete, production-grade video player for Flutter.</b><br>
  One unified controller. Native performance. Zero bloated binaries.
</p>

<p align="center">
  <a href="https://pub.dev/packages/better_player"><img src="https://img.shields.io/pub/v/better_player.svg" alt="Pub Version"></a>
  <a href="https://pub.dev/packages/better_player/score"><img src="https://img.shields.io/pub/points/better_player" alt="Pub Points"></a>
  <a href="https://pub.dev/packages/better_player/score"><img src="https://img.shields.io/pub/likes/better_player" alt="Pub Likes"></a>
  <a href="https://github.com/jhomlala/betterplayer"><img src="https://img.shields.io/github/stars/jhomlala/betterplayer?style=flat" alt="GitHub Stars"></a>
  <a href="https://github.com/jhomlala/betterplayer/blob/master/LICENSE"><img src="https://img.shields.io/github/license/jhomlala/betterplayer.svg" alt="License"></a>
</p>

<p align="center">
  <a href="https://jhomlala.github.io/betterplayer/"><b>Documentation</b></a> &bull;
  <a href="https://jhomlala.github.io/betterplayer/demo/"><b>Live Demo</b></a> &bull;
  <a href="https://jhomlala.github.io/betterplayer/migration_to_1.x.x"><b>Migrating to 1.x (from 0.0.x / better_player_plus)</b></a> &bull;
  <a href="https://jhomlala.github.io/betterplayer/migration_from_video_player"><b>Migrating from video_player</b></a> &bull;
  <a href="https://jhomlala.github.io/betterplayer/migration_from_chewie"><b>Migrating from chewie</b></a> &bull;
  <a href="https://jhomlala.github.io/betterplayer/migration_from_media_kit"><b>Migrating from media_kit</b></a> &bull;
  <a href="https://github.com/jhomlala/betterplayer/tree/master/packages/better_player_example"><b>Example App</b></a>
</p>

---

## Why Better Player?

Stop stitching `video_player`, separate UI packages, abandoned caching plugins, and custom DRM code together. Better Player packs the full video stack into a single, cohesive engine.

| Feature | Better Player | video_player + chewie | media_kit |
|---|:---:|:---:|:---:|
| **App Size Overhead** | **~1-2 MB** (Native OS engines) | ~1-2 MB | **+30MB to 50MB** (Bundled mpv binaries) |
| **Out-of-the-box UI** | Built-in & customizable | Chewie required | Built-in |
| **HLS / DASH** | Full native support | Basic | Native |
| **DRM (Widevine / FairPlay)** | Native support | None | None |
| **Smart Caching** | Built-in offline cache | None (3rd party needed) | None |
| **Subtitles & Closed Captions** | SRT, WebVTT, TTML, CEA-608 / CEA-708 | SRT only | Advanced |
| **Picture in Picture (PiP)** | Built-in | None | Platform-dependent |
| **Playlists** | Built-in | None | Built-in |
| **VAST / VMAP Ads** | Client-side ad engine (VAST 2.0-4.x, VMAP) | None | None |
| **Telemetry & QoE** | Real-time video metr