# FFmpegKitNext `FFmpegKitNext` is the official continuation of `FFmpegKit`. It builds on the foundations of `FFmpegKit` while improving the build infrastructure to reduce build failures, simplify maintenance and support future platform updates. ### 0. Features How is FFmpegKitNext different from FFmpegKit? `FFmpegKitNext` does not publish ready-to-use packages to `Maven Central`, `CocoaPods`, `pub.dev`, or `npm` as `FFmpegKit` did. To use it, build it locally for your target platform via the [Nix package manager](https://github.com/arthenica/ffmpeg-kit-next/wiki/Nix) or the MSYS2 / MinGW-w64 toolchain on Windows, then integrate the generated artifacts into your application. ### 1. Features - Nix package manager-based scripts to build FFmpeg native libraries for Android, Apple platforms, Linux and Web - Native Windows build script based on MSYS2 / MinGW-w64 - `FFmpegKitNext` wrapper library to run `FFmpeg`/`FFprobe` commands in applications - Supports native platforms: Android, iOS, iPadOS, Linux, macOS, tvOS, visionOS, Web and Windows - Supports hybrid platforms: Flutter, React Native - Based on FFmpeg `v6.1.x` or later with optional system and external libraries - Licensed under `LGPL 3.0` by default, `GPL v3.0` if GPL licensed libraries are enabled ### 2. Android See [Android](android) to learn more about `FFmpegKitNext` for `Android`. ### 3. iOS, iPadOS, macOS, tvOS, visionOS See [Apple](apple) to use `FFmpegKitNext` on `Apple` platforms (`iOS`, `iPadOS`, `macOS`, `tvOS`, `visionOS`). ### 4. Flutter See [Flutter](flutter/flutter) to learn more about `FFmpegKitNext` for `Flutter`. ### 5. Linux See [Linux](linux) to learn more about `FFmpegKitNext` for `Linux`. ### 6. React Native See [React Native](react-native) to learn more about `FFmpegKitNext` for `React Native`. ### 7. Web See [Web](web) to learn more about `FFmpegKitNext` for `Web` (`WebAssembly`). ### 8. Windows See [Windows](windows) to learn more about `FFmpegKitNext` for `Windows`. ### 9. Build Scripts `FFmpegKitNext` uses the [Nix package manager](https://github.com/arthenica/ffmpeg-kit-next/wiki/Nix) as the default and recommended build environment. It provides pinned inputs, toolchains, and platform-specific build packages for supported hosts. Install Nix on a supported host to build the project. Note that NixOS itself is not supported as a build host. See [Host Support](https://github.com/arthenica/ffmpeg-kit-next/wiki/Host-Support) before setting up a machine or CI image. Use `nix-android.sh`, `nix-ios.sh` (for both iOS and iPadOS), `nix-linux.sh`, `nix-macos.sh`, `nix-tvos.sh`, `nix-visionos.sh` and `nix-web.sh` to build `FFmpegKitNext` locally for Nix-supported target platforms. Building `FFmpegKitNext` without Nix is also supported. The non-Nix build workflow, together with script options for enabling optional libraries and disabling target architectures is explained in the [Building](https://github.com/arthenica/ffmpeg-kit-next/wiki/Building) wiki page. `Windows` is built without Nix using the `windows.sh` script from the project root. ### 10. FFmpegKitNext Library `FFmpegKitNext` is a wrapper library that allows you to easily run `FFmpeg`/`FFprobe` commands in applications. It provides additional features on top of `FFmpeg` to enable platform specific resources, control how commands are executed and how the results are handled. The `FFmpegKitNext` libraries provide the following APIs, which are identical in terms of features and capabilities. | Library | API | | --- | --- | | `Android` | `Kotlin` | | `Apple` (`iOS`, `iPadOS`, `tvOS`, `visionOS`) | `Objective-C` | | `Flutter` | `Dart` | | `macOS` | `Objective-C`, `C` | | `Linux` | `C++`, `C` | | `React Native` | `JavaScript` with `TypeScript` definitions | | `Web` | `JavaScript` with `TypeScript` definitions | | `Windows` | `C++`, `C` | ### 11. External Libraries The table below lists the optional external libraries that can be enabled in local `FFmpegKitNext` builds. Some parts of `FFmpeg` and some external libraries are licensed under the `GPL`. GPL libraries are included only when a GPL-enabled build variant is selected.
library name
external libraries chromaprint
dav1d
fontconfig
freetype
fribidi
gmp
gnutls
harfbuzz
kvazaar
lame
libaom
libass
libiconv
libilbc
libjxl
liblc3
libsvtav1
libtheora
libvorbis
libvpx
libwebp
libxml2
opencore-amr
openh264
openssl
opus
rubberband
sdl
shine
snappy
soxr
speex
srt
tesseract
twolame
vid.stab
vo-amrwbenc
vvenc
x264
x265
xvidcore
zimg
zlib
android system libraries zlib
MediaCodec
ios/ipados system libraries bzip2
AudioToolbox
AVFoundation
libiconv
VideoToolbox
zlib
linux system libraries alsa
libiconv
OpenCL
vaapi
v4l2
zlib
macos system libraries bzip2
AudioToolbox
AVFoundation
Core Image
libiconv
OpenCL
OpenGL
VideoToolbox
zlib
tvos system libraries bzip2
AudioToolbox
libiconv
VideoToolbox
zlib
visionos system libraries bzip2
AudioToolbox
libiconv
VideoToolbox
zlib
web system libraries iconv
zlib
- `AVFoundation` is not available on `tvOS` and `visionOS` ### 12. Versions `FFmpegKitNext` binaries generated use the same major and minor version numbers as the upstream `FFmpeg`1 project. The third and last number in the version string, if exists, is specific to `FFmpegKitNext`. It shows different releases from the same `FFmpeg` release branch. | Platforms | FFmpegKit Version | FFmpeg Version | Release Date | |:----------------:|:---------------------------------------------------------------------------------:|:--------------:|:------------:| | Android
Flutter
iOS / iPadOS
Linux
macOS
React Native
tvOS
visionOS
Web
Windows | [9.0.2](https://github.com/arthenica/ffmpeg-kit-next/releases/tag/v9.0.2) | 9.0.2 | Oct 24, 2026 | | Android
Flutter
iOS / iPadOS
Linux
macOS
React Native
tvOS
visionOS
Web
Windows | [9.0.1](https://github.com/arthenica/ffmpeg-kit-next/releases/tag/v9.0.1) | 9.0.2 | Oct 18, 2026 | | Android
Flutter
iOS / iPadOS
Linux
macOS
React Native
tvOS
visionOS
Web
Windows | [9.0.0](https://github.com/arthenica/ffmpeg-kit-next/releases/tag/v9.0.0) | 9.0.1 | Aug 24, 2026 | | Windows | [8.1.1](https://github.com/arthenica/ffmpeg-kit-next/releases/tag/v8.1.1.windows) | 8.1.2 | Aug 21, 2026 | | Android
Flutter
iOS / iPadOS
Linux
macOS
React Native
tvOS
visionOS
Web | [8.1.1](https://github.com/arthenica/ffmpeg-kit-next/releases/tag/v8.1.1) | 8.1.2 | Jul 28, 2026 | | Android
Flutter
iOS / iPadOS
Linux
macOS
React Native
tvOS | [8.1.0](https://github.com/arthenica/ffmpeg-kit-next/releases/tag/v8.1.0) | 8.1.2 | Jul 02, 2026 | | Android
Flutter
iOS / iPadOS
Linux
macOS
React Native
tvOS | [7.1.0](https://github.com/arthenica/ffmpeg-kit-next/releases/tag/v7.1.0) | 7.1.5 | Jul 01, 2026 | | Android
Flutter
iOS / iPadOS
Linux
macOS
React Native
tvOS | [6.1.1](https://github.com/arthenica/ffmpeg-kit-next/releases/tag/v6.1.1) | 6.1.6 | Jun 27, 2026 | | Android
Flutter
iOS / iPadOS
Linux
macOS
React Native
tvOS | [6.1.0](https://github.com/arthenica/ffmpeg-kit-next/releases/tag/v6.1.0) | 6.1.2 | Jun 26, 2026 | ### 13. Documentation A more detailed documentation is available under [Wiki](https://github.com/arthenica/ffmpeg-kit-next/wiki). - [Video tutorials](https://github.com/arthenica/ffmpeg-kit-next/wiki/Video-Tutorials) are available for selected build workflows and project features. All development takes place on the [`development`](https://github.com/arthenica/ffmpeg-kit-next/tree/development) branch. Open all pull requests against `development`; see the [contributing guidelines](CONTRIBUTING.md). ### 14. Test Applications You can see how `FFmpegKitNext` is used inside an application by running test applications created under [FFmpegKitNext Test](https://github.com/arthenica/ffmpeg-kit-next-test) project. The applications are **almost the same across platforms** and cover command execution, video encoding, accessing HTTPS URLs, audio encoding, burning subtitles, video stabilisation, pipe operations, ffkit protocols and concurrent command execution. Individual features depend on the capabilities available on each operating system or runtime. ### 15. License `FFmpegKitNext` library alone is licensed under the `LGPL v3.0`. `FFmpegKitNext` bundles (`.aar` archives, `frameworks`, `xcframeworks`), which include both `FFmpegKitNext` and `FFmpeg` libraries, are also licensed under the `LGPL v3.0`. However, if the source code is built using the optional `--enable-gpl` flag, then `FFmpegKitNext` bundles become subject to the `GPL v3.0`. Because, `FFmpeg` is licensed under the `GPL v3.0` in those bundles. And that makes the whole bundle effectively subject to the `GPL v3.0`. `FFmpegKitNext` build scripts always configure `FFmpeg` with `--enable-version3` option. And never enable non-free libraries. Thus, `FFmpeg` libraries created by `FFmpegKitNext` are licensed under the `LGPL v3.0` by default. Only when `--enable-gpl` is provided they become subject to `GPL v3.0`. Refer to [Licenses and Notices](https://github.com/arthenica/ffmpeg-kit-next/wiki/Licenses-and-Notices) to see the licenses of all libraries. [Trademarks](https://github.com/arthenica/ffmpeg-kit-next/wiki/Trademarks) lists the trademarks used in the `FFmpegKitNext` documentation. ### 16. Patents `FFmpeg`, `kvazaar`, `x264` and `x265` may implement codec technologies that are covered by patents in some jurisdictions. Patent rules vary by country and this documentation is not legal advice. If you use or distribute `ffmpeg-kit-next` in a country where software or codec patents are enforceable, you should consult qualified legal counsel to determine whether your use case requires a patent license or royalty payments. For more context, see the [FFmpeg Patent Mini-FAQ](https://ffmpeg.org/legal.html). `openh264` has separate patent-licensing considerations. Cisco states that it covers MPEG LA AVC/H.264 patent-pool royalties only for Cisco-distributed OpenH264 binary modules, subject to the applicable license terms and conditions. If you build `openh264` from source, include it in `ffmpeg-kit-next` and distribute the resulting library yourself, you may be responsible for any applicable patent licenses or royalties. See the [OpenH264 FAQ](https://www.openh264.org/faq.html) for details. ### 17. Trademarks 1 `FFmpeg` is a trademark of [Fabrice Bellard](http://www.bellard.org/). `FFmpegKitNext` and `FFmpegKit` are independent projects and not affiliated with the `FFmpeg` trademark holder. ### 18. See Also - [FFmpeg API Documentation](https://ffmpeg.org/doxygen/4.0/index.html) - [FFmpeg Wiki](https://trac.ffmpeg.org/wiki/WikiStart) - [FFmpeg External Library Licenses](https://www.ffmpeg.org/doxygen/4.0/md_LICENSE.html)