Skip to content
Android/iOS video player based on FFmpeg n3.4, with MediaCodec, VideoToolbox support. Backend for https://github.com/befovy/fijkplayer, fijkplayer 的播放内核
C Objective-C Java Shell C++ CMake Other
Branch: master
Clone or download
Pull request Compare This branch is 117 commits ahead of bilibili:master.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode fix: missing buffering update and position notify Nov 18, 2019
android chore(release): release f0.4.4 Nov 28, 2019
config chore: add mac ffmpeg module Nov 15, 2019
desktop feat: add libyuv for desktop to convert images\frames Nov 26, 2019
doc doc: add check item for openssl in takeoff list Apr 17, 2017
extra add android ndk cmake support, debug native c code in android studio Jun 29, 2019
ijkmedia feat: add libyuv for desktop to convert images\frames Nov 26, 2019
ijkprof/android-ndk-profiler-dummy/jni add android ndk cmake support, debug native c code in android studio Jun 29, 2019
ios chore(release): release f0.4.4 Nov 28, 2019
osx chore: add mac ffmpeg module Nov 15, 2019
tools tools: add copyrighter for copyright modification Feb 9, 2017
.gitignore feat: ijkplayer desktop works on Windows Nov 15, 2019
.travis.yml .travis: upgrade to buildtool 23.0.3 Apr 13, 2016
COPYING.GPLv2 COPYING: GPLv2 GPLv3 LGPLv2.1 LGPLv3 Jun 5, 2013
COPYING.GPLv3 COPYING: GPLv2 GPLv3 LGPLv2.1 LGPLv3 Jun 5, 2013
COPYING.LGPLv2.1 COPYING: GPLv2 GPLv3 LGPLv2.1 LGPLv3 Jun 5, 2013
COPYING.LGPLv2.1.txt podspec: support CocoaPods Jul 23, 2015
COPYING.LGPLv3 COPYING: GPLv2 GPLv3 LGPLv2.1 LGPLv3 Jun 5, 2013
MODULE_LICENSE_APACHE2 LICENSE: apache2 Jun 5, 2013
NEWS.md chore(release): release f0.4.4 Nov 28, 2019
NOTICE LICENSE: apache2 Jun 5, 2013
README.md update readme Jul 10, 2019
compile-android-j4a.sh copyright: add 2016 bilibili Feb 9, 2017
init-android-exo.sh copyright: add 2016 bilibili Feb 9, 2017
init-android-j4a.sh ijkplayer-j4a: upgrade jni4android to v0.0.2 May 3, 2017
init-android-libsoxr.sh copyright: add 2016 bilibili Feb 9, 2017
init-android-libyuv.sh copyright: add 2016 bilibili Feb 9, 2017
init-android-openssl.sh update openssl to OpenSSL_1_0_2r, add rtsp support Aug 17, 2019
init-android-prof.sh copyright: add 2016 bilibili Feb 9, 2017
init-android-soundtouch.sh ijkplayer/ijksoundtouch: delete some link Apr 18, 2017
init-android.sh rename module ijkplayer-full to fijkplayer-full Jul 1, 2019
init-config.sh copyright: add 2016 bilibili Feb 9, 2017
init-ios-openssl.sh update openssl to OpenSSL_1_0_2r, add rtsp support Aug 17, 2019
init-ios.sh ffmpeg: update to ff3.4--ijk0.8.7--20180103--001 Jan 24, 2018
init-osx.sh add MaxOSX FFmpeg build scripts Nov 6, 2019
version.sh k0.8.8 Feb 6, 2018

README.md

ijkplayer

Platform Build Status
Android Build Status
iOS Build Status

Video player based on ffplay

Download

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

dependencies {
    # required, enough for most devices.
    compile 'tv.danmaku.ijk.media:ijkplayer-java:0.8.8'
    compile 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.8.8'

    # Other ABIs: optional
    compile 'tv.danmaku.ijk.media:ijkplayer-armv5:0.8.8'
    compile 'tv.danmaku.ijk.media:ijkplayer-arm64:0.8.8'
    compile 'tv.danmaku.ijk.media:ijkplayer-x86:0.8.8'
    compile 'tv.danmaku.ijk.media:ijkplayer-x86_64:0.8.8'

    # ExoPlayer as IMediaPlayer: optional, experimental
    compile 'tv.danmaku.ijk.media:ijkplayer-exo:0.8.8'
}
  • iOS
  • in coming...

My Build Environment

Latest Changes

Features

  • Common
  • remove rarely used ffmpeg components to reduce binary size config/module-lite.sh
  • 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: android.media.MediaPlayer, 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)

NOT-ON-PLAN

  • 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 https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install git
brew install yasm

# add these lines to your ~/.bash_profile or ~/.profile
# export ANDROID_SDK=<your sdk path>
# export ANDROID_NDK=<your ndk path>

# on Cygwin (unmaintained)
# install git, make, yasm
  • If you prefer more codec/format
cd config
rm module.sh
ln -s module-default.sh module.sh
cd android/contrib
# cd ios
sh compile-ffmpeg.sh clean
  • If you prefer less codec/format for smaller binary size (include hevc function)
cd config
rm module.sh
ln -s module-lite-hevc.sh module.sh
cd android/contrib
# cd ios
sh compile-ffmpeg.sh clean
  • If you prefer less codec/format for smaller binary size (by default)
cd config
rm module.sh
ln -s module-lite.sh module.sh
cd android/contrib
# cd ios
sh compile-ffmpeg.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 https://github.com/Bilibili/ijkplayer.git ijkplayer-android
cd ijkplayer-android
git checkout -B latest k0.8.8

./init-android.sh

cd android/contrib
./compile-ffmpeg.sh clean
./compile-ffmpeg.sh all

cd ..
./compile-ijk.sh 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/patch-debugging-with-lldb.sh 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 patch-debugging-with-lldb.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
#
# Gradle
#     cd ijkplayer
#     gradle

Build Android via Cmake

Tested on ndk r15c.

git clone https://github.com/befovy/ijkplayer.git ijkplayer-android
cd ijkplayer-android

./init-android.sh

cd android/contrib
./compile-ffmpeg.sh clean
./compile-ffmpeg.sh all

just run/debug ijkplayer-example in Android Studio

To get a released aar run ./gradlew :fijkplayer-full:assembleRelease

Build iOS

git clone https://github.com/befovy/ijkplayer.git ijkplayer-ios
cd ijkplayer-ios
git checkout -B latest k0.8.8

./init-ios.sh

cd ios
./compile-ffmpeg.sh clean
./compile-ffmpeg.sh all

# Demo
#     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:
#         IJKMediaFramework.framework
#
#         AudioToolbox.framework
#         AVFoundation.framework
#         CoreGraphics.framework
#         CoreMedia.framework
#         CoreVideo.framework
#         libbz2.tbd
#         libz.tbd
#         MediaPlayer.framework
#         MobileCoreServices.framework
#         OpenGLES.framework
#         QuartzCore.framework
#         UIKit.framework
#         VideoToolbox.framework
#
#         ... (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 上公开讨论技术问题,不要以邮件方式私下询问,恕不一一回复。

License

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

ijkplayer required features are based on or derives from projects below:

android/ijkplayer-exo is based on or derives from projects below:

android/example is based on or derives from projects below:

ios/IJKMediaDemo is based on or derives from projects below:

ijkplayer's build scripts are based on or derives from projects below:

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.

You can’t perform that action at this time.