🎬 Youtube Video Webview for Flutter (Android & iOS)

Flutter

A customizable YouTube video player for Flutter, supporting embedded playback, fullscreen mode, sharing, captions, and seamless redirection to YouTube inside a webview.

✨ Features

  • 📐 Adjustable video height and width
  • 🌐 Redirects to the YouTube page inside a webview (via YouTube logo or video title)
  • 🖥️ Fullscreen video playback
  • 🔗 Share videos with a custom message
  • 💬 Caption (subtitles) control
  • ⚙️ Settings button (YouTube native menu)
  • 🧭 Multiple AppBar options for the redirected webview

↗️ Check out: Roadmap

🚀 Getting Started

Requirements

  • Flutter >= 1.17.0

📦 Installation

Add the package to your pubspec.yaml:

youtube_video_webview: ^1.0.0

Then run:

flutter pub get

🧩 Usage

1️⃣ Import the package

import 'package:youtube_video_webview/youtube_video_webview.dart';

2️⃣ Add the widget

YoutubeVideoWebview(
  videoId: '<VIDEO-ID>',
  referrerHeader: '<APP-IDENTIFIER-WITH-HTTPS>',
  externalBrowserSettings: YoutubePageWebViewSettings(
    appBar: YoutubeVideoWebviewAppBarShare(
      videoId: '<VIDEO-ID>',
      shareText: 'Check out this video!',
    ),
  ),
)

🌐 YouTube Page Webview Settings

Customize how the YouTube page opens when redirected:

YoutubePageWebViewSettings(
  dragToDismiss: true, // default
  appBar: YoutubeVideoWebviewAppBarShare(
    videoId: '<VIDEO-ID>',
    shareText: 'Check out this video!',
  ),
)

➡️ See App Bar Options

🧭 App Bar Options

🔹 Default App Bar

appBar: YoutubeVideoWebviewAppBarDefault()

🔹 Share App Bar

appBar: YoutubeVideoWebviewAppBarShare(
  videoId: '<VIDEO-ID>',
  shareText: 'Check out this video!',
)

🔹 Custom App Bar

appBar: YoutubeVideoWebviewAppBarCustom(
  appBar: AppBar(
    title: const Text('Custom App Bar'),
    backgroundColor: Colors.green,
  ),
)

🔹 No App Bar (Drag to Dismiss)

dragToDismiss: true

ℹ️ If no AppBar is provided, drag-to-dismiss is enabled automatically.

🧪 Additional Information

This package is under active development, but it is already stable and ready for production use.

🚧 More features and improvements coming soon!

🤝 Contributing

Found a bug or have an idea?

👉 Suggestions & Issues

👤 Author

🔗 LinkedIn

💻 GitHub

Libraries

youtube_video_webview