youtube_player_flutter

Introduction: Flutter plugin for playing or streaming YouTube videos inline using the official iFrame Player API. Supports both Android and iOS platforms.
More: Author   ReportBugs   
Tags:

Youtube Player iFrame Youtube Player Flutter youtube_player

Youtube Player for Flutter

A Flutter monorepo for seamless YouTube video playback, powered by the official iFrame Player API.

Stars Issues BSD-3 License


Package Version Demo Description Platforms
youtube_player pub 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 pub Platform interface for youtube_player (added automatically) All
youtube_player_android pub Android implementation for youtube_player (added automatically) Android
youtube_player_darwin pub iOS and macOS implementation for youtube_player (added automatically) iOS, macOS
youtube_player_html pub Web implementation for youtube_player (added automatically) Web
youtube_player_flutter pub demo Batteries-included YouTube player with built-in controls, gestures, and live stream UI Android, iOS, macOS, Web
youtube_player_iframe pub demo Full-control Flutter port of the YouTube iFrame API. Build your own UI. Android, iOS, macOS, Web
youtube_player_iframe_web pub 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.

Apps
About Me
GitHub: Trinea
Facebook: Dev Tools
AI Daily Digest