Awesome

Flutter video editor

A video editor that allows to edit (trim, crop, rotate and scale) and choose a cover with a very flexible UI design.

The library provides some tools to execute the exportation but does not handle it.

This library is written in Dart only but uses external packages such as video_thumbnail, which makes it available only on iOS and Android plaforms for now (web support is currently in progress).

Note If you use a version between (1.2.3 and 2.4.0) your project might be subject to a GPL license.

📖 Installation

Following steps will help you add this library as a dependency in your flutter project.

• Run flutter pub add video_editor, or add video_editor to pubspec.yaml file manually.

dependencies:
  video_editor: ^2.4.0

• Import the package in your code:

import 'package:video_editor/video_editor.dart';

📸 Screenshots

Example app running on an Iphone 11 pro	Customization example, light mode

👀 Usage

final VideoEditorController _controller = VideoEditorController.file(
  File('/path/to/video.mp4'),
  minDuration: const Duration(seconds: 1),
  maxDuration: const Duration(seconds: 10),
);

@override
void initState() {
  super.initState();
  _controller.initialize().then((_) => setState(() {}));
}

@override
void dispose() {
  _controller.dispose();
  super.dispose();
}

/// Basic export video function
Future<void> exportVideo() async {
  final config = VideoFFmpegVideoEditorConfig(_controller);
  // Returns the generated command and the output path
  final FFmpegVideoEditorExecute execute = await config.getExecuteConfig();

  // ... handle the video exportation yourself, using ffmpeg_kit_flutter, your own video server, ...
}

/// Export the video as a GIF image
Future<void> exportGif() async {
  final gifConfig = VideoFFmpegVideoEditorConfig(
    _controller,
    format: VideoExportFormat.gif,
  );
  // Returns the generated command and the output path
  final FFmpegVideoEditorExecute gifExecute = await gifConfig.getExecuteConfig();

  // ...
}

/// Export a video, with custom command (ultrafast preset + horizontal flip)
Future<void> exportMirroredVideo() async {
  final mirrorConfig = VideoFFmpegVideoEditorConfig(
      _controller,
      name: 'mirror-video'
      commandBuilder: (VideoFFmpegVideoEditorConfig config, String videoPath, String outputPath) {
        final List<String> filters = config.getExportFilters();
        filters.add('hflip'); // add horizontal flip

        return '-i $videoPath ${config.filtersCmd(filters)} -preset ultrafast $outputPath';
      },
    );
  // Returns the generated command and the output path
  final FFmpegVideoEditorExecute mirrorExecute = await mirrorConfig.getExecuteConfig();

  // ...
}

For more details check out the example.

VideoEditorController

Widgets

Crop

1. CropGridViewer

This widget is used to enable the crop actions on top of the video (CropGridViewer.edit), or only to preview the cropped result (CropGridViewer.preview).

Trimmer

1. TrimSlider

Display the trimmer containing video thumbnails with rotation and crop parameters.

2. TrimTimeline

Display the video timeline.

Cover

1. CoverSelection

Display a couple of generated covers with rotation and crop parameters to updated the selected cover.

2. CoverViewer

Display the selected cover with rotation and crop parameters.

Style

1. CropStyle

You can create your own CropStyle class to customize the CropGridViewer appareance.

2. TrimStyle

You can create your own TrimStyle class to customize the TrimSlider appareance.

3. CoverStyle

You can create your own CoverStyle class to customize the CoverSelection appareance.

Export

1. FFmpegVideoEditorConfig

2. VideoFFmpegVideoEditorConfig

Contains all FFmpegVideoEditorConfig parameters.

3. CoverFFmpegVideoEditorConfig

Contains all FFmpegVideoEditorConfig parameters.

💭 FAQ

1. Why was FFmpeg removed from this package ?

Starting from version 3.0.0, the video_editor package no longer includes ffmpeg_kit_flutter.

• The inclusion of ffmpeg_kit_flutter binary in this package caused numerous issues for users who intended to utilize a different instance of FFmpeg within the same project (#37, #129, #153).
• Additionally, it came to my attention that the video_editor package may have been mis-licensed and subject to the GPL v3.0 license since version 1.2.3, when it began utilizing the ffmpeg_kit_flutter_min_kit binary.
• Lastly, the FFmpeg package is quite large and significantly increases the app size, which is not ideal for developers seeking to handle exportation in a different way.

✨ Credit

Many thanks to seel-channel who is the original creator of this library.