Youtube Player for Flutter

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

---

Packages

Package	Version	Demo	Description	Platforms
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_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.

---

youtube_player_iframe_web: you probably don't need to add this

This is the web platform implementation consumed automatically by youtube_player_iframe. 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.