Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/starkdmi/media_tool_flutter
Flutter plugin for video, image and audio processing via native platform code
https://github.com/starkdmi/media_tool_flutter
android apple audio compressor converter ffmpeg flutter image image-processing ios macos video video-processing
Last synced: 3 months ago
JSON representation
Flutter plugin for video, image and audio processing via native platform code
- Host: GitHub
- URL: https://github.com/starkdmi/media_tool_flutter
- Owner: starkdmi
- License: mit
- Created: 2023-04-09T20:36:53.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-26T12:05:24.000Z (7 months ago)
- Last Synced: 2024-08-22T23:58:49.660Z (5 months ago)
- Topics: android, apple, audio, compressor, converter, ffmpeg, flutter, image, image-processing, ios, macos, video, video-processing
- Language: Dart
- Homepage: https://pub.dev/packages/media_tool_flutter
- Size: 17.4 MB
- Stars: 9
- Watchers: 1
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Media Tool Flutter
> Video, image and audio processing via native platform code.
## 🚧 WIP 🚧
Only Apple (iOS & macOS) support is implemented via native code yet.
## About
Flutter plugin for advanced media manipulation using native platform code. Supported media types are `video`, `audio` and `image`.
## Native Frameworks
| Platform | Framework |
| --- | --- |
| Apple | [MediaToolSwift](https://github.com/starkdmi/MediaToolSwift) |
| Android | MediaCodec\* |
| Windows & Linux | OpenCL\* |
\* Pull requests with implementation of `MediaToolPlatform` are welcome!
## Video
### Features:
- Compress with multiple codecs
- Resize
- Frame rate adjustment
- Audio track manipulataion
- Alpha channel and HDR handling
- Slow motion support
- Metadata preserving
- Hardware acceleration
- Thumbnails extraction
- Video information gathering
- Progress and cancellation
### Codecs
__Video__: `H.264`, `H.265/HEVC` and `ProRes`.
__Audio__: `AAC`, `Opus` and `FLAC`.
### Example
```Dart
// Compress video file
final task = VideoTool.compress(
id: id, // unique id
path: path,
destination: destination,
// Video
videoSettings: const VideoSettings(
codec: VideoCodec.h264,
bitrate: 2000000, // 2 Mbps
size: Size(1280.0, 1280.0), // size to fit in
// quality, frame rate, atd.
),
// Audio
skipAudio: false,
audioSettings: const AudioSettings(
codec: AudioCodec.opus,
bitrate: 96000, // 96 Kbps
// sample rate, quality, atd.
),
// Metadata and file options
skipMetadata: false,
overwrite: true,
deleteOrigin: false
);
// State notifier
task.events.listen(print);
// Cancellation
task.cancel();
```
## Image
### Features:
- Convert with multiple formats
- Resize and crop
- Frame rate adjustment
- Animated image sequences support
- Alpha channel and HDR handling
- Metadata and orientation preserving
- Image information gathering
### Formats:
- `JPEG`
- `PNG` and `APNG`
- `GIF`
- `TIFF`
- `BMP`
- `WEBP`
- `HEIF`
### Example
```Dart
// Convert image file
final metadata = await ImageTool.compress(
path: path,
destination: destination,
settings: const ImageSettings(
format: ImageFormat.png,
size: Size(1280.0, 1280.0),
crop: false, // crop or fit
// frame rate, quality, alpha channel, background color, atd.
),
skipMetadata: false,
overwrite: true,
deleteOrigin: false
);
```
## Audio
### Features:
- Compress with multiple codecs
- Metadata preserving
- Hardware acceleration
- Audio information gathering
- Progress and cancellation
### Codecs:
- `AAC`
- `Opus`
- `FLAC`
### Example
```Dart
// Compress audio file
final task = AudioTool.compress(
id: id, // unique id
path: path,
destination: destination,
settings: const AudioSettings(
codec: AudioCodec.opus,
bitrate: 96000, // 96 Kbps
// sample rate, quality, atd.
),
skipMetadata: false,
overwrite: true,
deleteOrigin: false
);
// State notifier
task.events.listen(print);
// Cancellation
task.cancel();
```
## Internally
Each plugin methods which run platform code do support multiple parallel executions, each of execution has it's own progress, cancellation and error handling. Main tests stored at [integration_test](media_tool/example/integration_test/).
## Benchmarks
### Video
| Plugin Name | Time |
| :-: | :-: |
| [media_tool_darwin](https://pub.dev/packages/media_tool_darwin) | __1x__ |
| [video_compress](https://pub.dev/packages/video_compress) | __1x__ |
| [light_compressor](https://pub.dev/packages/light_compressor) | __1.5-2x__ |
| [media_tool_ffmpeg](https://pub.dev/packages/media_tool_ffmpeg) | __8-12x__ |
Video tests were executed on macOS (Apple Silicon) using H.264/AAC/MP4 with 1280x720 and 1920x1080 resolutions.
### Image
| Plugin Name | Time |
| :-: | :-: |
| [media_tool_darwin](https://pub.dev/packages/media_tool_darwin) | __1x__ | /* up to 3x speed up on sequential calls (1/3x) */
| [media_tool_ffmpeg](https://pub.dev/packages/media_tool_ffmpeg) | __3-5x__ | /* no speed up on sequential calls */
| [image](https://pub.dev/packages/image) | __10x__ |
Image tests were executed on macOS (Apple Silicon) using PNG and JPEG.
## License
The Plugin is licensed under the MIT. The platform implementations may have their own licenses:
- MediaToolSwift - Mozilla Public License 2.0