Skip to content
This repository has been archived by the owner on Oct 7, 2021. It is now read-only.

Importing Frameworks

Taner Şener edited this page Oct 23, 2020 · 11 revisions

The recommended method to install mobile-ffmpeg in an iOS / tvOS project is to use Cocoapods. Adding mobile-ffmpeg dependency to the project's Podfile and running pod install is enough to complete the installation. Cocoapods will download necessary libraries and update the project files for you.

If Cocoapods is not available or you don't want to use Cocoapods on your project, you can install iOS / tvOS frameworks using instructions below.


1. Download an iOS framework package or a tvOS framework package from Releases page.

  • iOS framework releases are files ending with ios-framework postfix (or ios-xcframework for Main releases), e.g., mobile-ffmpeg-min-3.1-ios-framework.zip

  • tvOS framework releases are files ending with tvos-framework postfix, e.g., mobile-ffmpeg-video-4.2.2-tvos-framework.zip


2. Extract zip package in a temporary location and copy all frameworks (directories with .framework or .xcframework extension) into your project folder.


3. Open your project in Xcode and drag & drop all frameworks from Finder's project folder into your project window inside Xcode.

  • Make sure that Framework Search Path for PROJECT_DIR is set to recursive in Xcode
  • Validate that mobile-ffmpeg frameworks listed under Build Settings are not marked as Embed & Sign. The correct setting for them is Do Not Embed


4. Add libbz2, libc++, libiconv4, libz, CoreMotion1, GameController2, VideoToolbox3, Accelerate5 system libraries/frameworks to Build Phases -> Link Binary With Libraries section.

1 - Required by full and full-gpl packages on iOS

2 - Required by full and full-gpl packages

3 - Required by v3.0 or later, except tvOS LTS releases

4 - Required by v4.3.1 or later

5 - Required when rubberband is enabled

Clone this wiki locally