ijkplayer

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

Latest Changes

CHANGELOG.md

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/befovy/ijkplayer.git ijkplayer-android
cd ijkplayer-android

./init-android.sh

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

Open Android peoject in android/ijkplayer using Android Studio
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)
#

Build for Mac OS

Build ffmpeg for Max OS

./init-osx.sh
cd osx && ./compile-ffmpeg.sh

Build ijkplayer for Max OS

cd desktop
mkdir cmake-build-debug && cd cmake-build-debug
cmake .. -DCMAKE_BUILD_TYPE="Debug"
make IjkPlayer
make tuidemo

Or you can open ijkplayer as a CMakeLists.txt project using Clion.

tuidemo is a terminal UI demo for ijkplayer in progress, it can't display video yet.

libIjkPlayer.dylib is the output dynamic library.

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:

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:

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.

cdoco/ijkplayer