Skip to content

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

Notifications You must be signed in to change notification settings

konradkierus/android-ffmpeg-x264

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

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 Android.mk file to pack it into a shared library, rather than a large handful of custom Android.mk scripts (there are still a few script files but most of them are pretty small or are lists of configure options). Big custom Android.mk 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.

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:

  1. Run ./init-submodules.sh to pull in the FFMPEG and libx264 submodules.
  2. cd Project/jni
  3. do export NDK=~/apps/android-ndk-r5c using the actual path of your Android NDK.
  4. Run ./create_toolchain.sh to install a local copy of the standalone toolchain

Each time the 3rd party libraries change:

  1. Run ./config_make_everything.sh to configure and make libx264 and FFMPEG.
  2. ndk-build (make sure the NDK is in your $PATH)
  3. If all is well, you should find libs/armeabi/videokit.so.

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.

Options

  • minimal_featureset – on by default – only compiles in a small number of codecs (specifically, JPEG decoding and x264 encoding). Change to 0 in settings.sh 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 settings.sh to make the PATH point at its bin directory. Then you don’t need to run create_toolchain.sh. 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.

About

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

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 96.8%
  • Java 1.3%
  • Shell 1.3%
  • Makefile 0.6%