Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Android Videokit - basic FFMPEG+X264 build for Android. Pull requests gratefully accepted.
C Shell
Pull request Compare This branch is 3 commits ahead, 25 commits behind halfninja:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Android Videokit

This is a repository to make it relatively simple to fetch and build the latest FFMPEG and libx264 to run on Android, using the Android NDK. It differs from most of the other NDK FFMPEG building packages in that it uses configure and make to build the libraries, and only a very small file to pack it into a shared library, rather than a large handful of custom scripts (there are still a few script files but most of them are pretty small or are lists of configure options). Big custom files tend to break as soon as any files move around in the FFMPEG project, whereas here it should keep working with the latest libraries.

There is a skeletal JNI file that defines a few JNI files, but it really needs some more methods to be useful, and then a sister .java class. ffmpeg.c is a good place for inspiration. Pulls and patches are mega welcome.

How to build it

  1. Run ./ to pull in the FFMPEG and libx264 submodules.
  2. cd jni
  3. Edit to set NDK to the path of your Android NDK.
  4. Run ./ to install a local copy of the standalone toolchain
  5. Run ./ to configure and make libx264 and FFMPEG.
  6. ndk-build (make sure the NDK is in your $PATH)
  7. If all is well, you should find libs/armeabi/

You can edit jni/videokit/jni_interface.c to do whatever you want with the built libraries – if you make any changes to it, just run ndk-build to link it together with the static libraries.


  • minimal_featureset – on by default – only compiles in a small number of codecs (specifically, JPEG decoding and x264 encoding). Change to 0 in if you want everything, or just add whatever configure flags you like to pick the codecs and things that are useful to you.
  • If you have already created a standalone toolchain, just edit to make the PATH point at its bin directory. Then you don’t need to run If you have compilation problems, it’s worth making a fresh toolchain in case you’re using a slightly older version.

Updating submodules

The FFMPEG and X264 submodules will initially be fetched from a specific commit. If you want to try building with the latest, just go into each of those submodules and do a `git pull origin master`. FFMPEG tends to change quite a lot so don’t be surprised if it fails to build. If you get it working again with the latest, I’ll gladly patch my project with your changes.

Something went wrong with that request. Please try again.