Cache support for any video player with help of single line
Alternatives To Androidvideocache
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
9 days ago156apache-2.0Java
Cache support for any video player with help of single line
3 months ago8July 24, 202265apache-2.0Java
Android Video Player. 安卓视频播放器,封装MediaPlayer、ExoPlayer、IjkPlayer。模仿抖音并实现预加载,列表播放,悬浮播放,广告播放,弹幕,视频水印,视频滤镜
3 years ago33apache-2.0C
一个支持自定义UI布局,流式API, 加密,直播 ,亮度,音量,快进等手势 ,广告视频预览,多种加载模式 ,多种分辨率切换 ,多种封面图, 自定义数据源,列表播放,倍数播放,边播变缓存<font color="red">不是使用AndroidVideoCache</font>,离线播放,神奇的播放器
8 days ago35unlicenseJava
▶ Simple and lightweight, yet polished and powerful Android video player based on ExoPlayer
2 years ago14Java
This library uses OpenGL Shaders to apply effects on ExoPlayer video at Runtime
2 months ago23mitKotlin
The Easiest Way To Play/Stream Video And Audio Using Google ExoPlayer In Your Android Application
Exoplayer Kotlin108
14 days ago1Kotlin
Cookbook of multiple feature for Exoplayer
3 months ago4Java
Android music and video player. Uses ExoPlayer 2 and MediaPlayer for lower APIs and makes using ExoMediaPlayer easier. If you need advanced options such as handling Chromecast it is delivered by ExoMediaPlayer class.
a year agogpl-3.0Java
Yet Another Video Player for Andoid
a year ago4Kotlin
A video player based on Exoplayer
Alternatives To Androidvideocache
Select To Compare

Alternative Project Comparisons

Video cache support for Android

Android Arsenal Build Status Download

Table of Content

Why AndroidVideoCache?

Because there is no sense to download video a lot of times while streaming! AndroidVideoCache allows to add caching support to your VideoView/MediaPlayer, ExoPlayer or any another player with help of single line!


  • caching to disk during streaming;
  • offline work with cached resources;
  • partial loading;
  • cache limits (max cache size, max files count);
  • multiple clients for same url.

Note AndroidVideoCache works only with direct urls to media file, it doesn't support any streaming technology like DASH, SmoothStreaming, HLS.

Get started

Just add dependency (AndroidVideoCache is available in jcenter):

dependencies {
    compile 'com.danikula:videocache:2.7.1'

and use url from proxy instead of original url for adding caching:

protected void onCreate(Bundle savedInstanceState) {

    HttpProxyCacheServer proxy = getProxy();
    String proxyUrl = proxy.getProxyUrl(VIDEO_URL);

private HttpProxyCacheServer getProxy() {
    // should return single instance of HttpProxyCacheServer shared for whole app.

To guarantee normal work you should use single instance of HttpProxyCacheServer for whole app. For example you can store shared proxy in your Application:

public class App extends Application {

    private HttpProxyCacheServer proxy;

    public static HttpProxyCacheServer getProxy(Context context) {
        App app = (App) context.getApplicationContext();
        return app.proxy == null ? (app.proxy = app.newProxy()) : app.proxy;

    private HttpProxyCacheServer newProxy() {
        return new HttpProxyCacheServer(this);

or use simple factory. More preferable way is use some dependency injector like Dagger.


Disk cache limit

By default HttpProxyCacheServer uses 512Mb for caching files. You can change this value:

private HttpProxyCacheServer newProxy() {
    return new HttpProxyCacheServer.Builder(this)
            .maxCacheSize(1024 * 1024 * 1024)       // 1 Gb for cache

or can limit total count of files in cache:

private HttpProxyCacheServer newProxy() {
    return new HttpProxyCacheServer.Builder(this)

or even implement your own DiskUsage strategy:

private HttpProxyCacheServer newProxy() {
    return new HttpProxyCacheServer.Builder(this)
            .diskUsage(new MyCoolDiskUsageStrategy())

Listen caching progress

Use HttpProxyCacheServer.registerCacheListener(CacheListener listener) method to set listener with callback onCacheAvailable(File cacheFile, String url, int percentsAvailable) to be aware of caching progress. Do not forget to to unsubscribe listener with help of HttpProxyCacheServer.unregisterCacheListener(CacheListener listener) method to avoid memory leaks.

Use HttpProxyCacheServer.isCached(String url) method to check was url's content fully cached to file or not.

See sample app for more details.

Providing names for cached files

By default AndroidVideoCache uses MD5 of video url as file name. But in some cases url is not stable and it can contain some generated parts (e.g. session token). In this case caching mechanism will be broken. To fix it you have to provide own FileNameGenerator:

public class MyFileNameGenerator implements FileNameGenerator {

    // Urls contain mutable parts (parameter 'sessionToken') and stable video's id (parameter 'videoId').
    // e. g.
    public String generate(String url) {
        Uri uri = Uri.parse(url);
        String videoId = uri.getQueryParameter("videoId");
        return videoId + ".mp4";

HttpProxyCacheServer proxy = new HttpProxyCacheServer.Builder(context)
    .fileNameGenerator(new MyFileNameGenerator())

Adding custom http headers

You can add custom headers to requests with help of HeadersInjector:

public class UserAgentHeadersInjector implements HeaderInjector {

    public Map<String, String> addHeaders(String url) {
        return Maps.newHashMap("User-Agent", "Cool app v1.1");

private HttpProxyCacheServer newProxy() {
    return new HttpProxyCacheServer.Builder(this)
            .headerInjector(new UserAgentHeadersInjector())

Using exoPlayer

You can use exoPlayer with AndroidVideoCache. See sample app in exoPlayer branch. Note exoPlayer supports cache as well.


See sample app.

Known problems

  • In some cases clients can't connect to local proxy server ('Error pinging server' error). May be it is result of previous error. Note in this case video will be played, but without caching.

Whats new

See Release Notes here

Code contributions

If it's a feature that you think would need to be discussed please open an issue first, otherwise, you can follow this process:

  1. Fork the project
  2. Create a feature branch (git checkout -b my_branch)
  3. Fix a problem. Your code must contain test for reproducing problem. Your tests must be passed with help of your fix
  4. Push your changes to your new branch (git push origin my_branch)
  5. Initiate a pull request on github
  6. Rebase master branch if your local branch is not actual. Merging is not acceptable, only rebase
  7. Your pull request will be reviewed and hopefully merged :)

Where published?



[email protected]


Copyright 2014-2017 Alexey Danilov

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
Popular Video Player Projects
Popular Exoplayer Projects
Popular Media Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Video Player