{"id":13376417,"url":"https://github.com/bilibili/ijkplayer","last_synced_at":"2025-05-14T22:05:45.034Z","repository":{"id":8763549,"uuid":"10446890","full_name":"bilibili/ijkplayer","owner":"bilibili","description":"Android/iOS video player based on FFmpeg n3.4, with MediaCodec, VideoToolbox support.","archived":false,"fork":false,"pushed_at":"2024-08-13T00:53:33.000Z","size":8283,"stargazers_count":32848,"open_issues_count":2886,"forks_count":8187,"subscribers_count":1183,"default_branch":"master","last_synced_at":"2025-05-07T21:16:00.763Z","etag":null,"topics":["android","ffmpeg","ijkplayer","ios","player","video"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bilibili.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"COPYING.GPLv2","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-06-03T04:12:04.000Z","updated_at":"2025-05-07T14:16:26.000Z","dependencies_parsed_at":"2024-10-13T08:22:19.819Z","dependency_job_id":"43a969f3-4d5e-4422-8457-103ceffd2768","html_url":"https://github.com/bilibili/ijkplayer","commit_stats":{"total_commits":2588,"total_committers":62,"mean_commits":41.74193548387097,"dds":"0.21638330757341573","last_synced_commit":"30eb9441945da795079492041a791c121d2b8206"},"previous_names":[],"tags_count":78,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bilibili%2Fijkplayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bilibili%2Fijkplayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bilibili%2Fijkplayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bilibili%2Fijkplayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bilibili","download_url":"https://codeload.github.com/bilibili/ijkplayer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254235687,"owners_count":22036962,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","ffmpeg","ijkplayer","ios","player","video"],"created_at":"2024-07-30T06:00:44.905Z","updated_at":"2025-05-14T22:05:44.982Z","avatar_url":"https://github.com/bilibili.png","language":"C","readme":"# ijkplayer\n\n Platform | Build Status\n -------- | ------------\n Android | [![Build Status](https://travis-ci.org/Bilibili/ci-ijk-ffmpeg-android.svg?branch=master)](https://travis-ci.org/Bilibili/ci-ijk-ffmpeg-android)\n iOS | [![Build Status](https://travis-ci.org/Bilibili/ci-ijk-ffmpeg-ios.svg?branch=master)](https://travis-ci.org/Bilibili/ci-ijk-ffmpeg-ios)\n\nVideo player based on [ffplay](http://ffmpeg.org)\n\n### Download\n\n- Android:\n - Gradle\n```\n# required\nallprojects {\n    repositories {\n        jcenter()\n    }\n}\n\ndependencies {\n    # required, enough for most devices.\n    compile 'tv.danmaku.ijk.media:ijkplayer-java:0.8.8'\n    compile 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.8.8'\n\n    # Other ABIs: optional\n    compile 'tv.danmaku.ijk.media:ijkplayer-armv5:0.8.8'\n    compile 'tv.danmaku.ijk.media:ijkplayer-arm64:0.8.8'\n    compile 'tv.danmaku.ijk.media:ijkplayer-x86:0.8.8'\n    compile 'tv.danmaku.ijk.media:ijkplayer-x86_64:0.8.8'\n\n    # ExoPlayer as IMediaPlayer: optional, experimental\n    compile 'tv.danmaku.ijk.media:ijkplayer-exo:0.8.8'\n}\n```\n- iOS\n - in coming...\n\n### My Build Environment\n- Common\n - Mac OS X 10.11.5\n- Android\n - [NDK r10e](http://developer.android.com/tools/sdk/ndk/index.html)\n - Android Studio 2.1.3\n - Gradle 2.14.1\n- iOS\n - Xcode 7.3 (7D175)\n- [HomeBrew](http://brew.sh)\n - ruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"\n - brew install git\n\n### Latest Changes\n- [NEWS.md](NEWS.md)\n\n### Features\n- Common\n - remove rarely used ffmpeg components to reduce binary size [config/module-lite.sh](config/module-lite.sh)\n - workaround for some buggy online video.\n- Android\n - platform: API 9~23\n - cpu: ARMv7a, ARM64v8a, x86 (ARMv5 is not tested on real devices)\n - api: [MediaPlayer-like](android/ijkplayer/ijkplayer-java/src/main/java/tv/danmaku/ijk/media/player/IMediaPlayer.java)\n - video-output: NativeWindow, OpenGL ES 2.0\n - audio-output: AudioTrack, OpenSL ES\n - hw-decoder: MediaCodec (API 16+, Android 4.1+)\n - alternative-backend: android.media.MediaPlayer, ExoPlayer\n- iOS\n - platform: iOS 7.0~10.2.x\n - cpu: armv7, arm64, i386, x86_64, (armv7s is obselete)\n - api: [MediaPlayer.framework-like](ios/IJKMediaPlayer/IJKMediaPlayer/IJKMediaPlayback.h)\n - video-output: OpenGL ES 2.0\n - audio-output: AudioQueue, AudioUnit\n - hw-decoder: VideoToolbox (iOS 8+)\n - alternative-backend: AVFoundation.Framework.AVPlayer, MediaPlayer.Framework.MPMoviePlayerControlelr (obselete since iOS 8)\n\n### NOT-ON-PLAN\n- obsolete platforms (Android: API-8 and below; iOS: pre-6.0)\n- obsolete cpu: ARMv5, ARMv6, MIPS (I don't even have these types of devices…)\n- native subtitle render\n- avfilter support\n\n### Before Build\n```\n# install homebrew, git, yasm\nruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"\nbrew install git\nbrew install yasm\n\n# add these lines to your ~/.bash_profile or ~/.profile\n# export ANDROID_SDK=\u003cyour sdk path\u003e\n# export ANDROID_NDK=\u003cyour ndk path\u003e\n\n# on Cygwin (unmaintained)\n# install git, make, yasm\n```\n\n- If you prefer more codec/format\n```\ncd config\nrm module.sh\nln -s module-default.sh module.sh\ncd android/contrib\n# cd ios\nsh compile-ffmpeg.sh clean\n```\n\n- If you prefer less codec/format for smaller binary size (include hevc function)\n```\ncd config\nrm module.sh\nln -s module-lite-hevc.sh module.sh\ncd android/contrib\n# cd ios\nsh compile-ffmpeg.sh clean\n```\n\n- If you prefer less codec/format for smaller binary size (by default)\n```\ncd config\nrm module.sh\nln -s module-lite.sh module.sh\ncd android/contrib\n# cd ios\nsh compile-ffmpeg.sh clean\n```\n\n- For Ubuntu/Debian users.\n```\n# choose [No] to use bash\nsudo dpkg-reconfigure dash\n```\n\n- If you'd like to share your config, pull request is welcome.\n\n### Build Android\n```\ngit clone https://github.com/Bilibili/ijkplayer.git ijkplayer-android\ncd ijkplayer-android\ngit checkout -B latest k0.8.8\n\n./init-android.sh\n\ncd android/contrib\n./compile-ffmpeg.sh clean\n./compile-ffmpeg.sh all\n\ncd ..\n./compile-ijk.sh all\n\n# Android Studio:\n#     Open an existing Android Studio project\n#     Select android/ijkplayer/ and import\n#\n#     define ext block in your root build.gradle\n#     ext {\n#       compileSdkVersion = 23       // depending on your sdk version\n#       buildToolsVersion = \"23.0.0\" // depending on your build tools version\n#\n#       targetSdkVersion = 23        // depending on your sdk version\n#     }\n#\n# If you want to enable debugging ijkplayer(native modules) on Android Studio 2.2+: (experimental)\n#     sh android/patch-debugging-with-lldb.sh armv7a\n#     Install Android Studio 2.2(+)\n#     Preference -\u003e Android SDK -\u003e SDK Tools\n#     Select (LLDB, NDK, Android SDK Build-tools,Cmake) and install\n#     Open an existing Android Studio project\n#     Select android/ijkplayer\n#     Sync Project with Gradle Files\n#     Run -\u003e Edit Configurations -\u003e Debugger -\u003e Symbol Directories\n#     Add \"ijkplayer-armv7a/.externalNativeBuild/ndkBuild/release/obj/local/armeabi-v7a\" to Symbol Directories\n#     Run -\u003e Debug 'ijkplayer-example'\n#     if you want to reverse patches:\n#     sh patch-debugging-with-lldb.sh reverse armv7a\n#\n# Eclipse: (obselete)\n#     File -\u003e New -\u003e Project -\u003e Android Project from Existing Code\n#     Select android/ and import all project\n#     Import appcompat-v7\n#     Import preference-v7\n#\n# Gradle\n#     cd ijkplayer\n#     gradle\n\n```\n\n\n### Build iOS\n```\ngit clone https://github.com/Bilibili/ijkplayer.git ijkplayer-ios\ncd ijkplayer-ios\ngit checkout -B latest k0.8.8\n\n./init-ios.sh\n\ncd ios\n./compile-ffmpeg.sh clean\n./compile-ffmpeg.sh all\n\n# Demo\n#     open ios/IJKMediaDemo/IJKMediaDemo.xcodeproj with Xcode\n# \n# Import into Your own Application\n#     Select your project in Xcode.\n#     File -\u003e Add Files to ... -\u003e Select ios/IJKMediaPlayer/IJKMediaPlayer.xcodeproj\n#     Select your Application's target.\n#     Build Phases -\u003e Target Dependencies -\u003e Select IJKMediaFramework\n#     Build Phases -\u003e Link Binary with Libraries -\u003e Add:\n#         IJKMediaFramework.framework\n#\n#         AudioToolbox.framework\n#         AVFoundation.framework\n#         CoreGraphics.framework\n#         CoreMedia.framework\n#         CoreVideo.framework\n#         libbz2.tbd\n#         libz.tbd\n#         MediaPlayer.framework\n#         MobileCoreServices.framework\n#         OpenGLES.framework\n#         QuartzCore.framework\n#         UIKit.framework\n#         VideoToolbox.framework\n#\n#         ... (Maybe something else, if you get any link error)\n# \n```\n\n\n### Support (支持) ###\n- Please do not send e-mail to me. Public technical discussion on github is preferred.\n- 请尽量在 github 上公开讨论[技术问题](https://github.com/bilibili/ijkplayer/issues)，不要以邮件方式私下询问，恕不一一回复。\n\n\n### License\n\n```\nCopyright (c) 2017 Bilibili\nLicensed under LGPLv2.1 or later\n```\n\nijkplayer required features are based on or derives from projects below:\n- LGPL\n  - [FFmpeg](http://git.videolan.org/?p=ffmpeg.git)\n  - [libVLC](http://git.videolan.org/?p=vlc.git)\n  - [kxmovie](https://github.com/kolyvan/kxmovie)\n  - [soundtouch](http://www.surina.net/soundtouch/sourcecode.html)\n- zlib license\n  - [SDL](http://www.libsdl.org)\n- BSD-style license\n  - [libyuv](https://code.google.com/p/libyuv/)\n- ISC license\n  - [libyuv/source/x86inc.asm](https://code.google.com/p/libyuv/source/browse/trunk/source/x86inc.asm)\n\nandroid/ijkplayer-exo is based on or derives from projects below:\n- Apache License 2.0\n  - [ExoPlayer](https://github.com/google/ExoPlayer)\n\nandroid/example is based on or derives from projects below:\n- GPL\n  - [android-ndk-profiler](https://github.com/richq/android-ndk-profiler) (not included by default)\n\nios/IJKMediaDemo is based on or derives from projects below:\n- Unknown license\n  - [iOS7-BarcodeScanner](https://github.com/jpwiddy/iOS7-BarcodeScanner)\n\nijkplayer's build scripts are based on or derives from projects below:\n- [gas-preprocessor](http://git.libav.org/?p=gas-preprocessor.git)\n- [VideoLAN](http://git.videolan.org)\n- [yixia/FFmpeg-Android](https://github.com/yixia/FFmpeg-Android)\n- [kewlbear/FFmpeg-iOS-build-script](https://github.com/kewlbear/FFmpeg-iOS-build-script) \n\n### Commercial Use\nijkplayer is licensed under LGPLv2.1 or later, so itself is free for commercial use under LGPLv2.1 or later\n\nBut 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.\n\n[IANAL](https://en.wikipedia.org/wiki/IANAL), you should always ask your lawyer for these stuffs before use it in your product.\n","funding_links":[],"categories":["C","Media","[C-C++](#C-C++)","Mobile Development","HarmonyOS","📚 学习资料","Android 应用","OOM-Leaks-Crash","Projects List"],"sub_categories":["C++/C Toolkit","Windows Manager","🌐 开源框架","网络服务_其他","Player"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbilibili%2Fijkplayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbilibili%2Fijkplayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbilibili%2Fijkplayer/lists"}