config-plugins/ffmpeg-kit-react-native

Config plugin to auto-configure ffmpeg-kit-react-native when the native code is generated (npx expo prebuild).

Versioning

| expo | ffmpeg-kit-react-native | @config-plugins/ffmpeg-kit-react-native | | ------ | ------------------------- | ----------------------------------------- | | 52.0.0 | 6.0.2 | ^9.0.0 | | 51.0.0 | 6.0.2 | ^8.0.0 | | 50.0.0 | 6.0.2 | ^7.0.0 | | 49.0.0 | 5.1.0 | ^6.0.0 | | 48.0.0 | 5.1.0 | ^5.0.0 | | 47.0.0 | 5.1.0 | ^4.0.0 | | 46.0.0 | 4.5.2 | ^3.0.0 | | 45.0.0 | 4.5.1 | ^2.0.0 |

Expo installation

Tested against Expo SDK 50. Most packages worked on iOS. Not all packages have been tested on Android.

This package cannot be used in the "Expo Go" app because it requires custom native code.

First install the package with yarn, npm, or npx expo install.

npx expo install ffmpeg-kit-react-native @config-plugins/ffmpeg-kit-react-native

After installing this npm package, add the config plugin to the plugins array of your app.json or app.config.js:

{
  "expo": {
    "plugins": ["@config-plugins/ffmpeg-kit-react-native"]
  }
}

Next, rebuild your app as described in the "Adding custom native code" guide.

API

The plugin provides props for extra customization. Every time you change the props or plugins, you'll need to rebuild (and prebuild) the native app. If no extra properties are added, defaults will be used.

• package (string): Package to use. Options are: min, min-gpl, https, https-gpl, audio, video, full, full-gpl. Learn more.
• ios.package (string): Specify an iOS-only package.
• android.package (string): Specify an Android-only package.

Example

{
  "plugins": [
    [
      "@config-plugins/ffmpeg-kit-react-native",
      {
        "package": "min",
        "ios": {
          "package": "video"
        }
      }
    ]
  ]
}

Important Notes

• This plugin changes the minimum deployment target on Android to 24 (from 21) which may break other packages in your app!
• Changing the "package" field on iOS will require re-running pod install after updating with npx expo prebuild -p ios --no-install.
• Most of the modifications in this plugin are dangerous meaning it's highly likely that something may break over time. The plugin is heavily unit-tested to attempt to prevent breaking.