NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #3003 most downloaded on pub.dev
Trim videos in Flutter on Android, iOS, macOS, and the web, with a customizable trim viewer, playback controls, and video or GIF output.
Latest stable
6.0.0
Last release 19 days ago
03 Nov 2026
Release timing varies
gaps range from 8 days to 1.5 years
Nearly every release is documented
notes for 42 of 42 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
47 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
The biggest update since the native rewrite. It adds macOS and web support, fixes the crashes and dead-UI reports that new integrations hit first, mov
The biggest update since the native rewrite. It adds macOS and web support,
fixes the crashes and dead-UI reports that new integrations hit first, moves
thumbnails and trimming into the package's own native code, reworks scrolling
and playback, and adds line handles, minVideoLength, and restoring a saved
selection. See the README's "Migrating to 6.0.0" section when upgrading.
Trimmer.loadVideo takes the video's path (videoPath) instead of a
dart:io File, so the same code runs on the web: replace
loadVideo(videoFile: file) with loadVideo(videoPath: file.path). On the
web, pass a blob: URL, such as a picker's XFile.path.
Trimmer.currentVideoFile is now currentVideoPath.VideoPlayerController or the
Trimmer. The Trimmer owns the controller, and Trimmer.dispose()
releases it. Call Trimmer.dispose() from the State that created the
instance. (#250)get_thumbnail_video and
flutter_native_video_trimmer are no longer dependencies. Run
flutter clean (and pod install on iOS and macOS) if a build picks up
stale plugin registrations.minSdk is 24, the minimum video_player_android already
requires..mp4 on Android, and .mp4 on iOS and macOS except for .mov and
.m4v sources, which keep theirs. It used to copy the source's extension,
so a .webm or .mkv source on Android produced MP4 data under that name.onChangePlaybackState fires only when playback starts or stops, not on
every position update. (#236)Trimmer.loadVideo throws a FileSystemException on native platforms when
the file does not exist, instead of silently doing nothing.<name>_trimmed:<localized date>.<ext> to
<name>_trimmed_<yyyyMMdd_HHmmss>.<ext>. (#203, #214)DurationStyle no longer truncates the largest unit it is asked for:
FORMAT_MM_SS renders 1h30m15s as 90:15 rather than 30:15, and
FORMAT_SS renders 90s as 90 rather than 30.StorageDir is now a real enum. Existing call sites
(StorageDir.temporaryDirectory, .values, .index, toString()) behave
as before, but it can no longer be subclassed.ViewerType.scrollable on a video too short to scroll now reports a Flutter
error and falls back to the fixed viewer, rather than throwing a bare
String from a stream listener.TrimEditorProperties(handleStyle: TrimHandleStyle.circle) to keep the
previous look.<video> element, and trimming
runs in the browser with Mediabunny
(MPL-2.0) on WebCodecs, producing MP4. onSave receives a blob: URL, and
GIF output works too. Mediabunny is embedded in the web plugin only, so
apps on other platforms don't carry it. No part of the package's shared
code imports dart:io any more. Trimming needs a browser with WebCodecs:
current Chrome, Edge and Safari, and Firefox 130 or later.darwin/ and is shared
with macOS (sharedDarwinSource), so thumbnails and trimming use the same
AVFoundation code on both. JPEG encoding moved from UIKit to ImageIO for
that. The example app runs on macOS too.TrimEditorProperties.handleStyle picks
TrimHandleStyle.line (the new default) or TrimHandleStyle.circle, and
handleHeight sets a line's height in pixels or as a percentage of the trim
area: TrimHandleHeight.pixels(24) or TrimHandleHeight.percent(50) (the
default). circleSize and circleSizeOnDrag set the line's width, so it
still grows while it is dragged.TrimViewer.minVideoLength sets the shortest selection allowed. The
handles stop rather than close in past it, and a saved range shorter than
it grows to fit. Set it equal to maxVideoLength for a fixed-length
selection that can only be moved. (#188, #269)TrimViewer takes initialStartValue / initialEndValue (milliseconds,
the same values onChangeStart / onChangeEnd report) to open on a saved
selection. Both viewers honor them; the scrollable viewer scrolls the range
into view, and the preview starts on its first frame. Either can be given
alone, so initialEndValue also sets a shorter default selection than
maxVideoLength. (#73, #274, #209)sideTapSize instead of slicing
the frame into zones, so grabs near either end no longer move both
handles. (#234)TrimAreaProperties options: allowManualScroll, autoScrollEdgeZone,
maxAutoScrollVelocity, and autoScrollStartDelay. (#199)videoPlayerController.setLooping(true), playback wraps from the trim end
back to the trim start instead of pausing, including when the range ends at
the end of the video and the player loops on its own. (#237) Playback
stops or wraps at the trim end within a frame, instead of overshooting it by
up to one of the player's position reports, and a wrap at the end of the
video no longer flashes the video's first frame.flutter_native_video_trimmer gone, no dependency of the package lacks it,
so builds no longer warn.video_thumbnail no longer crash at launch on iOS
with Duplicate plugin key: VideoThumbnailPlugin. The get_thumbnail_video
dependency, and its libwebp pod, are gone. (#271, #266, #275)TrimViewer and VideoViewer rendered nothing forever when the video
finished initializing before they mounted — the await loadVideo() then
setState pattern, conditional builds, and hot reload. They now check the
Trimmer's state directly. (#215)onChangeStart, onChangeEnd, or onChangePlaybackState threw
Null check operator used on a null value. (#268)onChangePlaybackState no longer re-enter
until the stack overflows. (#236)Trimmer (for example by leaving the page) while
its video was still loading made that load hang forever and could stall the
next one. A controller is now released only after its initialize()
settles.Trimmer.dispose() while loadVideo was still running left a live,
initialized player behind, and two overlapping loadVideo calls both
emitted initialized and leaked the loser's player. Now the newest call
wins, a disposed Trimmer ignores loadVideo, and superseded loads release
everything they created.saveTrimmedVideo calls onSave(null) when the native trimmer produces no
file, instead of throwing a null-check error.saveTrimmedVideo dereferenced a null directory when
StorageDir.externalStorageDirectory was used off Android, and when the
storage value did not match its string-based switch. It now throws a clear
UnsupportedError. (#225)maxVideoLength cap, or the other handle, instead of up to one pointer
delta short. Diagonal drags no longer shift the handles vertically.path is accepted from 1.9.0. Flutter SDKs that pin path 1.9.0 through
flutter_test, such as 3.22, could not resolve the package at all.videoPlaybackControl starts from the trim start when the playhead is
before it, not only after the end.dispose(), which runs inside a
locked build scope, so any consumer calling setState there crashed on
teardown.dispose()'s pause()
notified it synchronously and crashed the same way.my.holiday.clip.mp4 kept only my.VideoViewer's padding argument was accepted and then ignored.TrimAreaProperties.edgeBlur() declared startIcon, endIcon, and
blurEdges as untyped parameters and never forwarded them, so custom icons
were silently discarded.Trimmer.loadVideo leaked the previous VideoPlayerController on every
reload, and the viewers' scrubber animation controllers and stream
subscriptions were never disposed.video_player 2.9.5, image 4.5.4, path 1.9.0) and allow the latest
releases. flutter_lints 6 is used for development.intl, transparent_image, and flutter_native_video_trimmer are no
longer dependencies. intl was only used to format output file names, and
its version is pinned by the Flutter SDK through flutter_localizations, so
every intl release risked a version conflict for apps that localize.
Dropping it resolves those conflicts for good. (#261) transparent_image
supplied one placeholder image, now part of the package.FixedTrimViewer and ScrollableTrimViewer so they can be used and
tested directly.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Got rid of the flutter_ffmpeg package and now uses a native video trimmer (Android and iOS)! 🎉
Got rid of the flutter_ffmpeg package and now uses a native video trimmer (Android and iOS)! 🎉
flutter_ffmpeg package has been discontinued by the author. Learn more about it here.ffmpegCommand and customVideoFormat properties. As those were specific to flutter_ffmpeg package.FileFormat no longer exists. A new enum is introduced called OutputType to choose between GIF and video output file.outputFormat no longer exists. By default the output has the same format as the original video.qualityGIF to specify the quality of the GIF.Use withValues instead of withOpacity as it's deprecated.
withValues instead of withOpacity as it's deprecated.Nothing published for this version
* Update readme.
Nothing published for this version
Fix thumbnail loading issue while using certain video formats.
video_thumbnail package (uses FFmpeg which is more reliable and efficient).Nothing published for this version
* Updates readme.
Nothing published for this version
NOTE: Separates the LTS version into a branched package version. By default, it will use the latest "Full" version of FFmpeg. To install the "LTS" ver
Nothing published for this version
* Update plugin versions.
Add new property for specifying DurationStyle.
DurationStyle.BREAKING CHANGE: Overhaul of the entire video trimmer implementation.
TrimViewer are available: FixedTrimViewer & ScrollableTrimViewer. By default it's set to auto so that it switches between these two based on the total video length and the maximum trim duration allowed.TrimEditor to TrimViewer. Check out this diagram for better understanding of the keywords/terms.TrimEditorProperties & TrimAreaProperties. Helps in identifying where the properties belong to easily.circleSizeOnDrag only on the selected holder.* Update plugin versions.
Changing path version to 1.8.0 (latest is 1.8.1) because it creates a conflict with flutter_test as it uses the older version.
path version to 1.8.0 (latest is 1.8.1) because it creates a conflict with flutter_test as it uses the older version.* Update plugin versions.
Format file (to pass static analysis).
Update ffmpeg_kit_flutter to 4.5.1-LTS.
BREAKING CHANGE: Migrate to FFmpegKit for Flutter. saveTrimmedVideo() method is not async now, you'll need to use the callback onSave: (outputPath) {}…
saveTrimmedVideo() method is not async now, you'll need to use the callback onSave: (outputPath) {} to get the trimmed video output path.showDuration.* Update the plugin versions. * Using flutter_lints.
* Update Docs.
Add borderWidth and scrubberWidth properties under TrimEditor widget.
borderWidth and scrubberWidth properties under TrimEditor widget.VideoViewer.Fix iOS error while loading thumbnails in TrimEditor.
TrimEditor.* Update the example in Readme. * Update the plugin versions.
Global refactoring, example is now a standalone screen.
Fix video thumbnail loading issues.
Update example app (small bug fixes).
Fixed the issue with video getting struck for a few initial frames during playback.
* Minor changes.
Improve the file structure of the package.
Update example app (now includes how to retrieve the trimmed video).
Add a new property called maxVideoLength for specifying the max length of the output video.
maxVideoLength for specifying the max length of the output video.Add a new property called fit to TrimEditor widget which will let you specify the image fit type of each thumbnail image.
Add a new property called fit to TrimEditor widget which will let you specify the image fit type of each thumbnail image.
Add a new property to saveTrimmedVideo() method called applyVideoEncoding which will let you specify whether to re-encode the trimmed video.
NOTE: Applying this will take significantly greater amount of time to process the output video.
Improve Docs.
Reverted the FFmpeg trimmed video start & end position to milliseconds (earlier it was changed to seconds in v0.2.4 to fix video freezing, but after t
v0.2.4 to fix video freezing, but after testing it was found that the issue still persists).Fix output video freezing during start and end.
* Fix issue with path returned.
Change implementation of the saveTrimmedVideo() method.
saveTrimmedVideo() method.saveTrimmedVideo() now returns the output video path.Fix over-scrolling && scroll-over issue.
BREAKING CHANGE: loadVideo() method implementation changed. Now, you can pass the video file to the method.
loadVideo() method implementation changed.
Now, you can pass the video file to the method.Fix for paths having white spaces.
Smoothen the scrubber animation.
* Code improvements. * Update Readme.
Changed StorageDir format naming.
StorageDir format naming.* Correct documentation.
* Initial Open Source release.
505
likes
150
points
12.4k
downloads
API reference
souvikbiswas.com
Trim videos in Flutter on Android, iOS, macOS, and the web, with a customizable trim viewer, playback controls, and video or GIF output.
Repository (GitHub)
View/report issues
#video #trimmer #video-editing #media
MIT ( license )
flutter , flutter_web_plugins , image , path , path_provider , video_player , web
Packages that depend on video_trimmer
Packages that implement video_trimmer
505
likes
150
points
12.4k
downloads
API reference
souvikbiswas.com
Trim videos in Flutter on Android, iOS, macOS, and the web, with a customizable trim viewer, playback controls, and video or GIF output.
Repository (GitHub)
View/report issues
#video #trimmer #video-editing #media
MIT ( license )
flutter , flutter_web_plugins , image , path , path_provider , video_player , web
Packages that depend on video_trimmer
Packages that implement video_trimmer
Back
One column per quarter.