## 1.0.0

* Initial release
* FFmpeg version 7.1.1
* Removed bundled Android FFmpeg (jniLibs, cpp, bindings)
* Added FFmpeg min using new Maven Central package
* Downgraded Kotlin version to `1.8.22`
* Updated `example` project and README.md

Author: sk3llo

README.md

@@ -19,22 +19,37 @@ _Fork of the original FFmpeg Kit library to work with Android V2 bindings and Fl
 
 ### 1. Features
 
-- Updated Android and MacOS bindings
-- Includes both `FFmpeg` and `FFprobe`
-- Supports
-    - `Android`, `iOS` and `macOS`
-- FFmpeg `v7.1.1`
-- Kotlin `v1.8.0`
-- `arm-v7a`, `arm-v7a-neon`, `arm64-v8a`, `x86` and `x86_64` architectures on Android
-    - `Android API Level 24` or later
-- `armv7`, `armv7s`, `arm64`, `x86_64`, `x86_64-mac-catalyst` and `arm64-mac-catalyst`  
-  architectures on iOS
-    - `iOS SDK 14.0` or later
-- `arm64` and `x86_64` architectures on macOS
-    - `macOS SDK 10.15` or later
-- Can process Storage Access Framework (SAF) Uris on Android
-
-- Licensed under `LGPL 3.0`
+- **Updated Bindings**: Android and macOS
+- **Includes**: Both `FFmpeg` and `FFprobe`
+- **Supported Platforms**:
+    - `Android`
+    - `iOS`
+    - `macOS`
+- **FFmpeg Version**: `v7.1.1`
+- **Kotlin Version**: `v1.8.22`
+- **Supported Architectures**:
+    - **Android**:
+        - `arm-v7a`
+        - `arm-v7a-neon`
+        - `arm64-v8a`
+        - `x86`
+        - `x86_64`
+        - Requires `Android API Level 24` or later
+    - **iOS**:
+        - `armv7`
+        - `armv7s`
+        - `arm64`
+        - `x86_64`
+        - `x86_64-mac-catalyst`
+        - `arm64-mac-catalyst`
+        - Requires `iOS SDK 14.0` or later
+    - **macOS**:
+        - `arm64`
+        - `x86_64`
+        - Requires `macOS SDK 10.15` or later
+- **Storage Access**: Can process Storage Access Framework (SAF) Uris on Android
+- **License**: Licensed under `LGPL 3.0`
+
 
 ### 2. Installation
 
@@ -49,14 +64,17 @@ dependencies:
 
 There are eight different `ffmpeg-kit` packages:
 
-- [Minimal](https://pub.dev/packages/ffmpeg_kit_flutter_new_min)
-- [Minimal-GPL](https://pub.dev/packages/ffmpeg_kit_flutter_new_min_gpl)
-- [HTTPS](https://pub.dev/packages/ffmpeg_kit_flutter_new_https)
-- [HTTPS-GPL](https://pub.dev/packages/ffmpeg_kit_flutter_new_https_gpl)
-- [Audio](https://pub.dev/packages/ffmpeg_kit_flutter_new_audio)
-- Video
-- Full
-- [Full-GPL](https://pub.dev/packages/ffmpeg_kit_flutter_new)
+| Package Name                     | Description                                                                                                   
+|----------------------------------|-----------------------------------------------
+| [Minimal](https://pub.dev/packages/ffmpeg_kit_flutter_new_min)                          | A minimal version of FFmpeg Kit                |
+| [Minimal-GPL](https://pub.dev/packages/ffmpeg_kit_flutter_new_min_gpl)                     | Minimal version with GPL licensing           
+| [HTTPS](https://pub.dev/packages/ffmpeg_kit_flutter_new_https)                            | FFmpeg Kit with HTTPS support                      |
+| [HTTPS-GPL](https://pub.dev/packages/ffmpeg_kit_flutter_new_https_gpl)                       | HTTPS version with GPL licensing               |
+| [Audio](https://pub.dev/packages/ffmpeg_kit_flutter_new_audio)                            | FFmpeg Kit focused on audio processing            |
+| Video                            | FFmpeg Kit focused on video processing                                                                        |
+| Full                             | Full version of FFmpeg Kit                                                                                     |
+| [Full-GPL](https://pub.dev/packages/ffmpeg_kit_flutter_new)                        | Full version with GPL licensing                        |
+
 
 Below you can see which system libraries and external libraries are enabled in each one of them.
 
@@ -142,14 +160,14 @@ The following table shows Android API level, iOS deployment target and macOS dep
 import 'package:ffmpeg_kit_flutter/ffmpeg_kit.dart';
 
 FFmpegKit.execute('-i file1.mp4 -c:v mpeg4 file2.mp4').then((session) async {
-    final returnCode = await session.getReturnCode();  
-    if (ReturnCode.isSuccess(returnCode)) {  
-    // SUCCESS  
-    } else if (ReturnCode.isCancel(returnCode)) {  
-    // CANCEL  
-    } else {  
-    // ERROR  
-    }
+final returnCode = await session.getReturnCode();
+if (ReturnCode.isSuccess(returnCode)) {
+// SUCCESS  
+} else if (ReturnCode.isCancel(returnCode)) {
+// CANCEL  
+} else {
+// ERROR  
+}
 });
 ```  
 
@@ -160,68 +178,68 @@ import 'package:ffmpeg_kit_flutter/ffmpeg_kit.dart';
 final outputPath = 'file2.mp4';
 
 FFmpegKit.execute('-i file1.mp4 -c:v mpeg4 file2.mp4').thenReturnResultOrLogs(
-    (_) => outputPath,
+(_) => outputPath,
 ).then((result) => print('FFmpeg command executed successfully: $result'))
-  .catchError((error) => print('FFmpeg command failed with error: $error'));
+    .catchError((error) => print('FFmpeg command failed with error: $error'));
 ```
 2. Each `execute` call creates a new session. Access every detail about your execution from the session created.
 
 ```dart  
-FFmpegKit.execute('-i file1.mp4 -c:v mpeg4 file2.mp4').then((session) async {  
-    // Unique session id created for this execution
-    final sessionId = session.getSessionId();  
-    // Command arguments as a single string
-    final command = session.getCommand();  
-    // Command arguments
-    final commandArguments = session.getArguments();  
-    // State of the execution. Shows whether it is still running or completed
-    final state = await session.getState();  
-    // Return code for completed sessions. Will be undefined if session is still running or FFmpegKit fails to run it
-    final returnCode = await session.getReturnCode();  
-    final startTime = session.getStartTime();
-    final endTime = await session.getEndTime();
-    final duration = await session.getDuration();  
-    // Console output generated for this execution
-    final output = await session.getOutput();  
-    // The stack trace if FFmpegKit fails to run a command
-    final failStackTrace = await session.getFailStackTrace();  
-    // The list of logs generated for this execution
-    final logs = await session.getLogs();  
-    // The list of statistics generated for this execution (only available on FFmpegSession)
-    final statistics = await (session as FFmpegSession).getStatistics();  
+FFmpegKit.execute('-i file1.mp4 -c:v mpeg4 file2.mp4').then((session) async {
+// Unique session id created for this execution
+final sessionId = session.getSessionId();
+// Command arguments as a single string
+final command = session.getCommand();
+// Command arguments
+final commandArguments = session.getArguments();
+// State of the execution. Shows whether it is still running or completed
+final state = await session.getState();
+// Return code for completed sessions. Will be undefined if session is still running or FFmpegKit fails to run it
+final returnCode = await session.getReturnCode();
+final startTime = session.getStartTime();
+final endTime = await session.getEndTime();
+final duration = await session.getDuration();
+// Console output generated for this execution
+final output = await session.getOutput();
+// The stack trace if FFmpegKit fails to run a command
+final failStackTrace = await session.getFailStackTrace();
+// The list of logs generated for this execution
+final logs = await session.getLogs();
+// The list of statistics generated for this execution (only available on FFmpegSession)
+final statistics = await (session as FFmpegSession).getStatistics();
 });
 ```  
 3. Execute `FFmpeg` commands by providing session specific `execute`/`log`/`session` callbacks.
 
 ```dart  
 FFmpegKit.executeAsync('-i file1.mp4 -c:v mpeg4 file2.mp4', (Session session) async {
-    // CALLED WHEN SESSION IS EXECUTED  
-}, (Log log) {  
-    // CALLED WHEN SESSION PRINTS LOGS  
-}, (Statistics statistics) {  
-    // CALLED WHEN SESSION GENERATES STATISTICS  
+// CALLED WHEN SESSION IS EXECUTED  
+}, (Log log) {
+// CALLED WHEN SESSION PRINTS LOGS  
+}, (Statistics statistics) {
+// CALLED WHEN SESSION GENERATES STATISTICS  
 });
 ```  
 4. Execute `FFprobe` commands.
 
 ```dart  
-FFprobeKit.execute(ffprobeCommand).then((session) async {  
-    // CALLED WHEN SESSION IS EXECUTED  
+FFprobeKit.execute(ffprobeCommand).then((session) async {
+// CALLED WHEN SESSION IS EXECUTED  
 });  
 ```  
 5. Get media information for a file/url.
 
 ```dart  
-FFprobeKit.getMediaInformation('<file path or url>').then((session) async {  
-    final information = await session.getMediaInformation();  
-    if (information == null) {  
-        // CHECK THE FOLLOWING ATTRIBUTES ON ERROR
-        final state = FFmpegKitConfig.sessionStateToString(await session.getState());
-        final returnCode = await session.getReturnCode();
-        final failStackTrace = await session.getFailStackTrace();
-        final duration = await session.getDuration();
-        final output = await session.getOutput();
-    }
+FFprobeKit.getMediaInformation('<file path or url>').then((session) async {
+final information = await session.getMediaInformation();
+if (information == null) {
+// CHECK THE FOLLOWING ATTRIBUTES ON ERROR
+final state = FFmpegKitConfig.sessionStateToString(await session.getState());
+final returnCode = await session.getReturnCode();
+final failStackTrace = await session.getFailStackTrace();
+final duration = await session.getDuration();
+final output = await session.getOutput();
+}
 });
 ```  
 6. Stop ongoing FFmpeg operations.
@@ -239,37 +257,37 @@ FFmpegKit.cancel(sessionId);
 
 - Reading a file:
 ```dart  
-FFmpegKitConfig.selectDocumentForRead('*/*').then((uri) {  
-    FFmpegKitConfig.getSafParameterForRead(uri!).then((safUrl) {
-        FFmpegKit.executeAsync("-i ${safUrl!} -c:v mpeg4 file2.mp4");
-    });
+FFmpegKitConfig.selectDocumentForRead('*/*').then((uri) {
+FFmpegKitConfig.getSafParameterForRead(uri!).then((safUrl) {
+FFmpegKit.executeAsync("-i ${safUrl!} -c:v mpeg4 file2.mp4");
+});
 });
 ```  
 - Writing to a file:
 ```dart  
 FFmpegKitConfig.selectDocumentForWrite('video.mp4', 'video/*').then((uri) {
-    FFmpegKitConfig.getSafParameterForWrite(uri!).then((safUrl) {
-        FFmpegKit.executeAsync("-i file1.mp4 -c:v mpeg4 ${safUrl}");
-    });
+FFmpegKitConfig.getSafParameterForWrite(uri!).then((safUrl) {
+FFmpegKit.executeAsync("-i file1.mp4 -c:v mpeg4 ${safUrl}");
+});
 });  
 ```  
 8. Get previous `FFmpeg`, `FFprobe` and `MediaInformation` sessions from the session history.
 
 ```dart  
-FFmpegKit.listSessions().then((sessionList) {  
-    sessionList.forEach((session) {
-        final sessionId = session.getSessionId();
-    });
-});  
+FFmpegKit.listSessions().then((sessionList) {
+sessionList.forEach((session) {
+final sessionId = session.getSessionId();
+});
+});
 FFprobeKit.listFFprobeSessions().then((sessionList) {
-    sessionList.forEach((session) {
-        final sessionId = session.getSessionId();
-    });
-});  
+sessionList.forEach((session) {
+final sessionId = session.getSessionId();
+});
+});
 FFprobeKit.listMediaInformationSessions().then((sessionList) {
-    sessionList.forEach((session) {
-        final sessionId = session.getSessionId();
-    });
+sessionList.forEach((session) {
+final sessionId = session.getSessionId();
+});
 });
 ```  
 9. Enable global callbacks.
@@ -278,20 +296,20 @@ FFprobeKit.listMediaInformationSessions().then((sessionList) {
 
 ```dart  
 FFmpegKitConfig.enableFFmpegSessionCompleteCallback((session) {
-    final sessionId = session.getSessionId();
-});  
+final sessionId = session.getSessionId();
+});
 FFmpegKitConfig.enableFFprobeSessionCompleteCallback((session) {
-    final sessionId = session.getSessionId();
-});  
+final sessionId = session.getSessionId();
+});
 FFmpegKitConfig.enableMediaInformationSessionCompleteCallback((session) {
-    final sessionId = session.getSessionId();
+final sessionId = session.getSessionId();
 });  
 ```  
 - Log Callback, called when a session generates logs
 
 ```dart  
-FFmpegKitConfig.enableLogCallback((log) {  
-    final message = log.getMessage();
+FFmpegKitConfig.enableLogCallback((log) {
+final message = log.getMessage();
 });
 ```  
 - Statistics Callback, called when a session generates statistics

android/build.gradle

@@ -1,5 +1,5 @@
 buildscript {
-    ext.kotlin_version = "1.8.0"
+    ext.kotlin_version = "1.8.22"
 
     repositories {
         google()

example/.gitignore

@@ -31,6 +31,7 @@ migrate_working_dir/
 .flutter-plugins-dependencies
 .pub-cache/
 .pub/
+pubspec.lock
 /build/
 
 # Symbolication related

example/analysis_options.yaml

@@ -1,63 +1 @@
-analyzer:
-  strong-mode:
-    implicit-dynamic: false
-  errors:
-    missing_required_param: warning
-    missing_return: warning
-
-linter:
-  rules:
-    - avoid_catching_errors
-    - avoid_function_literals_in_foreach_calls
-    - avoid_private_typedef_functions
-    - avoid_renaming_method_parameters
-    - avoid_returning_null_for_void
-    - avoid_unused_constructor_parameters
-    - avoid_void_async
-    - await_only_futures
-    - camel_case_types
-    - cancel_subscriptions
-    - comment_references
-    - constant_identifier_names
-    - control_flow_in_finally
-    - directives_ordering
-    - empty_statements
-    - file_names
-    - hash_and_equals
-    - implementation_imports
-    - join_return_with_assignment
-    - lines_longer_than_80_chars
-    - missing_whitespace_between_adjacent_strings
-    - no_runtimeType_toString
-    - non_constant_identifier_names
-    - only_throw_errors
-    - overridden_fields
-    - package_names
-    - package_prefixed_library_names
-    - prefer_asserts_in_initializer_lists
-    - prefer_const_constructors
-    - prefer_const_declarations
-    - prefer_expression_function_bodies
-    - prefer_final_locals
-    - prefer_function_declarations_over_variables
-    - prefer_initializing_formals
-    - prefer_inlined_adds
-    - prefer_interpolation_to_compose_strings
-    - prefer_is_not_operator
-    - prefer_null_aware_operators
-    - prefer_relative_imports
-    - prefer_typing_uninitialized_variables
-    - prefer_void_to_null
-    - provide_deprecation_message
-    - sort_pub_dependencies
-    - test_types_in_equals
-    - throw_in_finally
-    - unnecessary_brace_in_string_interps
-    - unnecessary_lambdas
-    - unnecessary_null_aware_assignments
-    - unnecessary_overrides
-    - unnecessary_parenthesis
-    - unnecessary_statements
-    - unnecessary_string_interpolations
-    - use_string_buffers
-    - void_checks
+include: package:flutter_lints/flutter.yaml

example/android/settings.gradle.kts

@@ -19,7 +19,7 @@ pluginManagement {
 plugins {
     id("dev.flutter.flutter-plugin-loader") version "1.0.0"
     id("com.android.application") version "8.7.0" apply false
-    id("org.jetbrains.kotlin.android") version "2.2.0" apply false
+    id("org.jetbrains.kotlin.android") version "1.8.22" apply false
 }
 
 include(":app")