Need help with android-ffmpeg-x264?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

428 Stars 293 Forks 53 Commits 4 Opened issues


INACTIVE, UNSUPPORTED - Android Videokit - basic FFMPEG+X264 build for Android. Pull requests gratefully accepted.

Services available


Need anything else?

Contributors list

# 96,314
46 commits

h1. Read me first (that's why I'm at the top!)

I'm not going to be working on this at all for the forseeable future, and I won't have time to answer questions about why it doesn't compile on your platform or has something missing.

There are a few forks of this project on GitHub where a few people have updated it and improved on the scripts. Check them out!

h1. 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 @[email protected] scripts (there are still a few script files but most of them are pretty small or are lists of configure options). Big custom @[email protected] 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 interface - the version here simply supplies run(String[]) which is passed to ffmpeg.c's origin main() function. Once I've got this properly encoding again, I'll make some more convenient methods.

h2. How to build it

You'll need to git clone in order to have access to the submodules. You might be able to use a ZIP download but then you'll have to skip the init-submodules step and acquire FFmpeg and x264 from elsewhere; if you do this and something doesn't work then I really can't help you. Use git, it's good!

First time stuff:

Clone using the @[email protected] switch. (Or clone normally and run @./[email protected] to pull in the FFMPEG and libx264 submodules.)

@cd Project/[email protected]

do @export NDK=~/apps/[email protected] using the actual path of your Android NDK.

Run @./[email protected] to install a local copy of the standalone toolchain

Each time the 3rd party libraries change:

Run @./configmake[email protected] to configure and make libx264 and FFMPEG.

@[email protected] (make sure the NDK is in your $PATH)

If all is well, you should find @libs/armeabi/[email protected]

You can edit @jni/videokit/[email protected] 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.

h2. Options

  • @[email protected] - on by default - only compiles in a small number of codecs (specifically, JPEG decoding and x264 encoding). Change to 0 in @[email protected] 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 @[email protected] to make the PATH point at its bin directory. Then you don't need to run @[email protected] If you have compilation problems, it's worth making a fresh toolchain in case you're using a slightly older version.

h2. 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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.