youtube_player_flutter

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter plugin that enables inline playback of YouTube videos using the official iFrame Player API. It supports multiple platforms including Android, iOS, Web, macOS, and Windows, offering a seamless way to integrate YouTube content into Flutter applications. The plugin provides customizable video players with support for various playback controls, events, and quality settings. Developers can easily embed and manage YouTube videos within their apps without relying on external players or complex workarounds.

Use cases

Embedding YouTube videos in mobile apps
Streaming videos within web applications
Creating video tutorials or content hubs
Integrating video playback in educational apps
Building media-rich Flutter experiences

Key features

Supports iFrame Player API
Cross-platform compatibility
Customizable player UI
Event handling for playback states
Responsive design across devices
Video quality selection

Suitable for

Developers building media-heavy apps
Educational or tutorial platforms
Content delivery applications
Apps requiring embedded video streaming
Flutter teams targeting multiple platforms

Considerations

Requires internet connection for video loading
Limited customization compared to native players
Depends on YouTube's API availability
Potential performance impact on low-end devices
May require additional permissions on some platforms

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Youtube Player for Flutter

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

Packages

Package	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.

Search packages, repositories and app categories

Install package