youtube-dl-android
Android library wrapper for youtube-dl executable. Based on yausername's youtubedl-android but with ability to download binary files at runtime to decrease apk size.
Credits
- youtubedl-java by sapher, youtubedl-android adds android compatibility to youtubedl-java.
- youtubedl-android by yausername, youtube-dl-android adds ondemand library files download compatibility to youtubedl-android.
Installation
Gradle
Step 1 : Add jitpack repository to your project build file
allprojects {
repositories {
maven { url 'https://jitpack.io' }
}
}
Step 2: Add the dependency
dependencies {
implementation 'com.github.bawaviki.youtube-dl-android:library:0.7.+'
}
Optional FFmpeg dependency can also be added
dependencies {
implementation 'com.github.bawaviki.youtube-dl-android:library:0.7.+'
implementation 'com.github.bawaviki.youtube-dl-android:ffmpeg:0.7.+'
}
Usage
- youtube-dl executable and python 3.7 are bundled in the library.
- Initialize library, preferably in
onCreate
.
try {
YoutubeDL.getInstance().init(getApplication(),this);
} catch (YoutubeDLException e) {
Log.e(TAG, "failed to initialize youtubedl-android", e);
}
- Downloading / custom command (A detailed example can be found in the sample app)
File youtubeDLDir = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS), "youtubedl-android");
YoutubeDLRequest request = new YoutubeDLRequest("https://vimeo.com/22439234");
request.setOption("-o", youtubeDLDir.getAbsolutePath() + "/%(title)s.%(ext)s");
YoutubeDL.getInstance().execute(request, (progress, etaInSeconds) -> {
System.out.println(String.valueOf(progress) + "% (ETA " + String.valueOf(etaInSeconds) + " seconds)");
});
- Get stream info (equivalent to
--dump-json
of youtube-dl)
VideoInfo streamInfo = YoutubeDL.getInstance().getInfo("https://vimeo.com/22439234");
System.out.println(streamInfo.getTitle());
- Get Playlist info (equivalent to
--dump-single-json
of youtube-dl)
PlaylistInfo playlistInfo = YoutubeDL.getInstance().getPlaylistInfo("https://www.youtube.com/playlist?list=PLpuxPG4TUOR4N78vlcDHu46hM1LDrz8Lw");
System.out.println(playlistInfo.Id());
-
youtube-dl supports myriad different options which be seen here
-
youtube-dl binary can be updated from within the library
YoutubeDL.getInstance().updateYoutubeDL(getApplication());
FFmpeg
If you wish to use ffmpeg features of youtube-dl (e.g. --extract-audio), include and initialize the ffmpeg library(you only need to Initialize FFmpeg library youtube-dl already initialize in this).
try {
FFmpeg.getInstance().init(getApplication(),this);
} catch (YoutubeDLException e) {
Log.e(TAG, "failed to initialize ffmpeg", e);
}
Sample app
Docs
- Though not required for just using this library, documentation on building python for android can be seen here. Same for ffmpeg here.
- youtubedl-android uses lazy extractors based build of youtube-dl (youtubedl-lazy)