simple_youtube_player 0.1.1

A simple and easy-to-use YouTube video player widget for Flutter. Just provide a URL and size, and you're ready to go! Supports all YouTube URL formats with auto-play, mute, loop, and control options.

Changelog

All notable changes to Simple YouTube Player will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

---

0.1.1 - 2025-12-06

🎉 Initial Release

The first public release of Simple YouTube Player! A lightweight, easy-to-use YouTube video player widget for Flutter.

✨ Added

Core Features

• 🎥 SimpleYoutubePlayer Widget: Main widget for embedding YouTube videos
• 🔗 Smart URL Parser: Automatically detects and handles multiple YouTube URL formats
  • Standard format: youtube.com/watch?v=VIDEO_ID
  • Short format: youtu.be/VIDEO_ID
  • Embed format: youtube.com/embed/VIDEO_ID
  • Mobile format: m.youtube.com/watch?v=VIDEO_ID
  • Direct video ID support

Customization Options

• 📐 Size Control: Configurable width and height
• ▶️ Auto-play: Option to start video automatically
• 🔇 Mute Control: Start videos with or without sound
• 🔁 Loop Mode: Infinite video looping
• 🎮 Controls Toggle: Show or hide YouTube player controls

Advanced Features

• 🎮 Player Controller: SimpleYoutubePlayerController for advanced control
  • State monitoring (isPlaying, isLoading)
  • Error tracking and handling
  • Listener support for state changes

UI/UX

• 🎨 Loading Indicators: Beautiful loading state with progress indicator
• 🛡️ Error Handling: User-friendly error messages with icons
• ✨ Rounded Corners: Aesthetic 8px border radius
• 📱 Responsive Design: Works perfectly on all screen sizes

Platform Support

• ✅ Android - Full support
• ✅ iOS - Full support
• ✅ Web - Full support
• ✅ macOS - Full support
• ✅ Windows - Full support
• ✅ Linux - Full support

📚 Documentation

• 📖 Comprehensive README: Complete usage guide with 8+ code examples
• 💡 Multiple Examples:
  • Basic usage
  • Advanced controller usage
  • Responsive layouts
  • Video lists
  • Styled players
  • Background videos
• 🎯 Best Practices: DO's and DON'Ts guide
• 🐛 Troubleshooting: Common issues and solutions
• 📋 Parameter Reference: Complete API documentation

🔧 Technical

• Dependencies:

  • webview_flutter: ^4.4.2 - For video rendering
  • Flutter SDK: >=3.0.0
  • Dart SDK: >=3.0.0 <4.0.0

• Architecture:

  • Clean separation of concerns
  • Modular code structure
  • Well-documented codebase
  • Null-safe implementation

📦 Example App

• 🎬 Complete Demo Application: Showcases all features
• 🎨 Multiple Screens: Different use cases demonstrated
• 📱 Production-Ready: Can be used as reference implementation

📄 License

• MIT License - Free for personal and commercial use

---

[Unreleased]

🚀 Planned Features for Future Releases

v0.2.0

• ⚡ Playback Speed: Control video playback speed
• 🎥 Quality Selection: Choose video quality (360p, 720p, 1080p, etc.)
• 📺 Picture-in-Picture: Floating video window support
• 🖥️ Fullscreen Mode: Native fullscreen support

v0.3.0

• 📝 Subtitle Support: Enable/disable captions
• 📊 Progress Tracking: Track video watch progress
• 🎚️ Volume Control: Programmatic volume adjustment
• ⏸️ Player Events: onPlay, onPause, onEnded callbacks

v1.0.0 (Stable Release)

• 🎯 Performance Optimizations: Faster loading and better memory management
• 🔐 Private Video Support: Handle authentication for private videos
• 🌍 Localization: Multi-language error messages
• 📱 Offline Caching: Cache videos for offline viewing

💡 Feature Requests

Have an idea? Open an issue with the label enhancement!

---

Version Naming Convention

This project follows Semantic Versioning:

• MAJOR version (1.0.0): Incompatible API changes
• MINOR version (0.1.0): New features, backwards compatible
• PATCH version (0.0.1): Bug fixes, backwards compatible

Examples:

• 0.0.1 → 0.0.2: Bug fix
• 0.0.1 → 0.1.0: New feature added
• 0.9.0 → 1.0.0: First stable release or breaking changes

---

How to Report Issues

Found a bug? Please help us improve!

1. 🔍 Search existing issues to avoid duplicates
2. 📝 Create new issue with:
   • Clear title
   • Step-by-step reproduction
   • Expected vs actual behavior
   • Flutter/Dart version
   • Platform (iOS/Android/Web/etc.)
   • Screenshots if applicable

Report Issue →

---

Contributing

Want to contribute? Check out:

• CONTRIBUTING.md - Contribution guidelines
• CODE_OF_CONDUCT.md - Community guidelines
• Open Issues - Find something to work on

---

Special Thanks

Thanks to everyone who contributed to this release:

• 🎨 Designers who inspired the simple API
• 🧪 Beta testers who found early bugs
• 💬 Community members who provided feedback
• ⭐ Everyone who starred the repository!

---

Note: This is an initial release. Expect rapid improvements and feature additions based on community feedback. Please report any issues you encounter!

---

Quick Links

• 📦 Package on pub.dev
• 💻 Source Code
• 📖 Documentation
• 🐛 Issue Tracker

---

Made with for the Flutter community

⭐ Star | 📦 Install | 🐛 Report