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

About the developer

29.5K Stars 7.6K Forks Other 2.6K Commits 2.7K Opened issues


Android/iOS video player based on FFmpeg n3.4, with MediaCodec, VideoToolbox support.

Services available


Need anything else?

Contributors list



Build Status
Android Build Status
iOS Build Status

Video player based on ffplay


  • Android:
    • Gradle ``` # required allprojects { repositories { jcenter() } }

dependencies { # required, enough for most devices. compile '' compile ''

# Other ABIs: optional
compile ''
compile ''
compile ''
compile ''

ExoPlayer as IMediaPlayer: optional, experimental

compile ''

} ``` - iOS - in coming...

My Build Environment

  • Common
    • Mac OS X 10.11.5
  • Android
    • NDK r10e
    • Android Studio 2.1.3
    • Gradle 2.14.1
  • iOS
    • Xcode 7.3 (7D175)
  • HomeBrew
    • ruby -e "$(curl -fsSL"
    • brew install git

Latest Changes


  • Common
    • remove rarely used ffmpeg components to reduce binary size config/
    • workaround for some buggy online video.
  • Android
    • platform: API 9~23
    • cpu: ARMv7a, ARM64v8a, x86 (ARMv5 is not tested on real devices)
    • api: MediaPlayer-like
    • video-output: NativeWindow, OpenGL ES 2.0
    • audio-output: AudioTrack, OpenSL ES
    • hw-decoder: MediaCodec (API 16+, Android 4.1+)
    • alternative-backend:, ExoPlayer
  • iOS
    • platform: iOS 7.0~10.2.x
    • cpu: armv7, arm64, i386, x86_64, (armv7s is obselete)
    • api: MediaPlayer.framework-like
    • video-output: OpenGL ES 2.0
    • audio-output: AudioQueue, AudioUnit
    • hw-decoder: VideoToolbox (iOS 8+)
    • alternative-backend: AVFoundation.Framework.AVPlayer, MediaPlayer.Framework.MPMoviePlayerControlelr (obselete since iOS 8)


  • obsolete platforms (Android: API-8 and below; iOS: pre-6.0)
  • obsolete cpu: ARMv5, ARMv6, MIPS (I don't even have these types of devices…)
  • native subtitle render
  • avfilter support

Before Build

# install homebrew, git, yasm
ruby -e "$(curl -fsSL"
brew install git
brew install yasm

add these lines to your ~/.bash_profile or ~/.profile



on Cygwin (unmaintained)

install git, make, yasm

  • If you prefer more codec/format ``` cd config rm ln -s cd android/contrib

    cd ios

    sh clean ```

  • If you prefer less codec/format for smaller binary size (include hevc function) ``` cd config rm ln -s cd android/contrib

    cd ios

    sh clean ```

  • If you prefer less codec/format for smaller binary size (by default) ``` cd config rm ln -s cd android/contrib

    cd ios

    sh clean ```

  • For Ubuntu/Debian users. ```

    choose [No] to use bash

    sudo dpkg-reconfigure dash ```

  • If you'd like to share your config, pull request is welcome.

Build Android

git clone ijkplayer-android
cd ijkplayer-android
git checkout -B latest k0.8.8


cd android/contrib ./ clean ./ all

cd .. ./ all

Android Studio:

Open an existing Android Studio project

Select android/ijkplayer/ and import

define ext block in your root build.gradle

ext {

compileSdkVersion = 23 // depending on your sdk version

buildToolsVersion = "23.0.0" // depending on your build tools version

targetSdkVersion = 23 // depending on your sdk version


If you want to enable debugging ijkplayer(native modules) on Android Studio 2.2+: (experimental)

sh android/ armv7a

Install Android Studio 2.2(+)

Preference -> Android SDK -> SDK Tools

Select (LLDB, NDK, Android SDK Build-tools,Cmake) and install

Open an existing Android Studio project

Select android/ijkplayer

Sync Project with Gradle Files

Run -> Edit Configurations -> Debugger -> Symbol Directories

Add "ijkplayer-armv7a/.externalNativeBuild/ndkBuild/release/obj/local/armeabi-v7a" to Symbol Directories

Run -> Debug 'ijkplayer-example'

if you want to reverse patches:

sh reverse armv7a

Eclipse: (obselete)

File -> New -> Project -> Android Project from Existing Code

Select android/ and import all project

Import appcompat-v7

Import preference-v7


cd ijkplayer


Build iOS

git clone ijkplayer-ios
cd ijkplayer-ios
git checkout -B latest k0.8.8


cd ios ./ clean ./ all


open ios/IJKMediaDemo/IJKMediaDemo.xcodeproj with Xcode

Import into Your own Application

Select your project in Xcode.

File -> Add Files to ... -> Select ios/IJKMediaPlayer/IJKMediaPlayer.xcodeproj

Select your Application's target.

Build Phases -> Target Dependencies -> Select IJKMediaFramework

Build Phases -> Link Binary with Libraries -> Add:















... (Maybe something else, if you get any link error)

Support (支持)

  • Please do not send e-mail to me. Public technical discussion on github is preferred.
  • 请尽量在 github 上公开讨论技术问题,不要以邮件方式私下询问,恕不一一回复。


Copyright (c) 2017 Bilibili
Licensed under LGPLv2.1 or later

ijkplayer required features are based on or derives from projects below: - LGPL - FFmpeg - libVLC - kxmovie - soundtouch - zlib license - SDL - BSD-style license - libyuv - ISC license - libyuv/source/x86inc.asm

android/ijkplayer-exo is based on or derives from projects below: - Apache License 2.0 - ExoPlayer

android/example is based on or derives from projects below: - GPL - android-ndk-profiler (not included by default)

ios/IJKMediaDemo is based on or derives from projects below: - Unknown license - iOS7-BarcodeScanner

ijkplayer's build scripts are based on or derives from projects below: - gas-preprocessor - VideoLAN - yixia/FFmpeg-Android - kewlbear/FFmpeg-iOS-build-script

Commercial Use

ijkplayer is licensed under LGPLv2.1 or later, so itself is free for commercial use under LGPLv2.1 or later

But ijkplayer is also based on other different projects under various licenses, which I have no idea whether they are compatible to each other or to your product.

IANAL, you should always ask your lawyer for these stuffs before use it in your product.

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.