This plugin generates thumbnail from video file or URL. It returns image in memory or writes into a file. It offers rich options to control the image format, resolution and quality. Supports iOS and Android.
| function | parameter | description | return |
|---|---|---|---|
| thumbnailData | String [video], optional Map<String, dynamic> [headers], ImageFormat [imageFormat](JPEG/PNG/WEBP), int [maxHeight](0: for the original resolution of the video, or scaled by the source aspect ratio), [maxWidth](0: for the original resolution of the video, or scaled by the source aspect ratio), int [timeMs]generates the thumbnail from the frame around the specified millisecond, int[quality]`(0-100) | generates thumbnail from [video] | [Future<Uint8List>] |
| thumbnailFile | String [video], optional Map<String, dynamic> [headers], String [thumbnailPath](folder or full path where to store the thumbnail file, null to save to same folder as the video file), ImageFormat [imageFormat](JPEG/PNG/WEBP), int [maxHeight](0: for the original resolution of the video, or scaled by the source aspect ratio), int [maxWidth](0: for the original resolution of the video, or scaled by the source aspect ratio), int [timeMs] generates the thumbnail from the frame around the specified millisecond, int [quality](0-100) | creates a file of the thumbnail from the [video] | [Future<String>] |
Warning:
Giving both the
maxHeightandmaxWidthhas different result on Android platform, it actually scales the thumbnail to the specified maxHeight and maxWidth. To generate the thumbnail from a network resource, thevideomust be properly URL encoded.
Installing add video_thumbnail as a dependency in your pubspec.yaml file.
dependencies: video_thumbnail: ^0.5.3import
import 'package:video_thumbnail/video_thumbnail.dart';Generate a thumbnail in memory from video file
final uint8list = await VideoThumbnail.thumbnailData( video: videofile.path, imageFormat: ImageFormat.JPEG, maxWidth: 128, // specify the width of the thumbnail, let the height auto-scaled to keep the source aspect ratio quality: 25, );Generate a thumbnail file from video URL
final fileName = await VideoThumbnail.thumbnailFile( video: "https://flutter.github.io/assets-for-api-docs/assets/videos/butterfly.mp4", thumbnailPath: (await getTemporaryDirectory()).path, imageFormat: ImageFormat.WEBP, maxHeight: 64, // specify the height of the thumbnail, let the width auto-scaled to keep the source aspect ratio quality: 75, );Generate a thumbnail file from video Assets declared in pubspec.yaml
final byteData = await rootBundle.load("assets/my_video.mp4"); Directory tempDir = await getTemporaryDirectory(); File tempVideo = File("${tempDir.path}/assets/my_video.mp4") ..createSync(recursive: true) ..writeAsBytesSync(byteData.buffer.asUint8List(byteData.offsetInBytes, byteData.lengthInBytes)); final fileName = await VideoThumbnail.thumbnailFile( video: tempVideo.path, thumbnailPath: (await getTemporaryDirectory()).path, imageFormat: ImageFormat.PNG, quality: 100, );Fork or pull requests are always welcome. Currently it seems have a little performance issue while generating WebP thumbnail by using libwebp under iOS.