smart_video_thumbnail 0.1.1 copy "smart_video_thumbnail: ^0.1.1" to clipboard
smart_video_thumbnail: ^0.1.1 copied to clipboard

PlatformAndroid

High-performance Flutter plugin for extracting video thumbnails using native FFmpeg engine. Supports all video formats (MP4, AVI, MKV, FLV, etc.) with CPU-only decoding.

Changelog #

All notable changes to this project will be documented in this file.

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

0.1.1 - 2026-02-13 #

🎉 Changed #

  • Simplified Installation: Switched from GitHub Packages to JitPack for native library distribution
  • No Credentials Required: Users no longer need GitHub Personal Access Tokens
  • Easier Setup: Removed the need for ~/.gradle/gradle.properties configuration

📦 Technical Changes #

  • Updated native library dependency from com.smartmedia:smart-ffmpeg-android to com.github.Daronec:smart-ffmpeg-android
  • Changed repository from GitHub Packages to JitPack (https://jitpack.io)
  • Native library now automatically downloads on first build

🔄 Migration Guide #

If you're upgrading from v0.1.0:

  1. Remove GitHub credentials from ~/.gradle/gradle.properties (no longer needed)
  2. Clean build cache:
    flutter clean
    cd example && flutter clean
    
  3. Update dependency:
    dependencies:
      smart_video_thumbnail: ^0.1.1
    
  4. Rebuild:
    flutter pub get
    flutter build apk
    

The plugin will now automatically download the native library from JitPack on first build.

✅ Benefits #

  • ✅ No GitHub account or token required
  • ✅ Simpler installation process
  • ✅ Works out of the box after flutter pub get
  • ✅ Standard Android library distribution method

0.1.0 - 2026-02-13 #

🎉 Initial Release #

First public release of smart_video_thumbnail - a powerful Flutter plugin for video thumbnail generation.

✨ Features #

  • Native FFmpeg Integration - Uses FFmpeg 4.4.2 for reliable video decoding
  • Universal Format Support - Works with MP4, AVI, MKV, FLV, WMV, and all FFmpeg-compatible formats
  • High Performance - Optimized frame extraction (50-300ms per thumbnail)
  • Flexible API - Configurable dimensions, time position, and seek strategies
  • RGBA8888 Output - Standard pixel format for easy integration with Flutter widgets
  • Multiple Strategies - Normal, keyframe, and firstFrame extraction modes
  • Robust Error Handling - Comprehensive error messages and logging

📱 Platform Support #

  • Android - Full support for Android 8.0+ (API 26+)
  • iOS - Coming in future releases

📦 What's Included #

  • Complete Flutter plugin with Dart API
  • Native FFmpeg library integration (v4.4.2)
  • Example app with grid layout demonstration
  • Comprehensive documentation and usage examples
  • GitHub Packages integration for native dependencies

🔧 Technical Details #

  • FFmpeg Version: 4.4.2
  • Supported Codecs: H.264, H.265, MPEG-4, VP8, VP9, and more
  • Output Format: RGBA8888 (4 bytes per pixel)
  • Library Size: ~8MB (native libraries)
  • Min SDK: Android 26 (Android 8.0)

📚 Documentation #

  • Full API reference in README.md
  • Usage examples and code snippets
  • Architecture documentation
  • Performance benchmarks
  • Debugging guide

⚠️ Known Limitations #

  • Android only (iOS support planned)
  • Synchronous API (may block UI thread for large videos)
  • Requires GitHub token for native library access during build
1
likes
160
points
110
downloads
screenshot

Publisher

unverified uploader

Weekly Downloads

High-performance Flutter plugin for extracting video thumbnails using native FFmpeg engine. Supports all video formats (MP4, AVI, MKV, FLV, etc.) with CPU-only decoding.

Repository (GitHub)
View/report issues

Topics

#video #thumbnail #ffmpeg #video-processing #media

Documentation

Documentation
API reference

License

MIT (license)

Dependencies

flutter

More

Packages that depend on smart_video_thumbnail

Packages that implement smart_video_thumbnail