youtube_player_flutter
Youtube Player for Flutter
A Flutter monorepo for seamless YouTube video playback, powered by the official iFrame Player API.
| Package | Version | Demo | Description | Platforms |
|---|---|---|---|---|
| youtube_player | New plain IFrame player on native WebViews (Pigeon Native Interop, no webview_flutter). Custom UI via controlsBuilder. |
Android, iOS, macOS, Web | ||
| youtube_player_platform_interface | Platform interface for youtube_player (added automatically) |
All | ||
| youtube_player_android | Android implementation for youtube_player (added automatically) |
Android | ||
| youtube_player_darwin | iOS and macOS implementation for youtube_player (added automatically) |
iOS, macOS | ||
| youtube_player_html | Web implementation for youtube_player (added automatically) |
Web | ||
| youtube_player_flutter | Batteries-included YouTube player with built-in controls, gestures, and live stream UI | Android, iOS, macOS, Web | ||
| youtube_player_iframe | Full-control Flutter port of the YouTube iFrame API. Build your own UI. | Android, iOS, macOS, Web | ||
| youtube_player_iframe_web | Web platform implementation for youtube_player_iframe (added automatically) |
Web |
Which package should I use?
youtube_player: the new federated player
A from-scratch IFrame player built on a minimal native WebView per platform, driven through Pigeon Native Interop (JNI on Android, FFI on iOS/macOS) with no platform channels and no webview_flutter. It draws no Flutter UI of its own; add custom controls through YoutubePlayer.controlsBuilder. It will eventually replace youtube_player_iframe, and youtube_player_flutter will be rebuilt on top of it.
flutter pub add youtube_player
Best for: new projects that want a lean, modern player. Requires Dart 3.14+ and Flutter 3.50+.
youtube_player_flutter: just want a player that works
The quickest path to YouTube playback in your app. It ships with ready-made controls, a progress bar, drag-to-seek, pinch-to-fullscreen, and a live stream UI, all out of the box. Drop it in, point it at a video ID, and you're done.
flutter pub add youtube_player_flutter
Best for: apps that want a polished, functional player with minimal setup.
youtube_player_iframe: want full control over the player
A lower-level package that gives you the complete YouTube iFrame API. You own the UI; the package handles playback state, playlists, metadata, fullscreen transitions, thumbnails, and more. Includes a lazy-loading thumbnail widget perfect for video lists.
flutter pub add youtube_player_iframe
Best for: apps with a custom player design, complex playback logic, or playlist management needs.
Platform packages: you probably don't need to add these
youtube_player_iframe_web, youtube_player_platform_interface, youtube_player_android, youtube_player_darwin and youtube_player_html are consumed automatically by youtube_player_iframe and youtube_player. You only need to add it directly if you're building a platform plugin or working inside this monorepo.
License
BSD-3-Clause. See LICENSE for details.
This project uses the YouTube IFrame Player API. By using these packages, you agree to the YouTube API Services Terms of Service.
API method documentation is adapted from the YouTube IFrame Player API Reference, © Google LLC, licensed under CC BY 4.0. See NOTICE for details.
