Kotlin YouTube Extractor

Android Library for extract YouTube Stream URL

A lightweight Android (Kotlin) library for extract YouTube streaming URL. Port from HaarigerHarald/android-youtubeExtractor (Java) to Kotlin.

Features

• Get YouTube stream Url with all format and itag
• Get YouTube video metadata
• Using Kotlin Coroutines for best performance

Using in your project

Gradle

Add Jitpack.io to your setting.gradle file:

pluginManagement {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Then, add dependencies in app level build.gradle:

dependencies {
    implementation 'com.github.maxrave-dev:kotlin-youtubeExtractor:0.0.7'
}

How to use

Using with Kotlin Coroutines

From version 0.0.3, this library change extract method and add more feature method.

Before start please add Kotlin Coroutines to your project

Call YTExtractor inside your activity or fragment

//If your YouTube link is "https://www.youtube.com/watch?v=IDwytT0wFRM" so this videoId is "IDwytT0wFRM"
var videoId = "IDwytT0wFRM"
val yt = YTExtractor(con = context, CACHING = true, LOGGING = true, retryCount = 3)
// CACHING and LOGGING are 2 optional params. LOGGING is for showing Log and CACHING is for saving SignatureCipher to optimize extracting time (not recommend CACHING to extract multiple videos because it causes HTTP 403 Error)
// retryCount is for retrying when extract fail (default is 1)
var ytFiles: SparseArray<YtFile>? = null
var videoMeta: VideoMeta? = null
GlobalScope.launch {
            yt.extract(videoId)
            //Before get YtFile or VideoMeta, you need to check state of yt object
            if (yt.state == State.SUCCESS) {
                ytFiles = yt.getYTFiles()
                videoMeta = yt.getVideoMeta()
            }
        }

In above case, ytFiles is a map of available media files for one YouTube video, accessible by their itag value (in above code "251" is a audio itag) and videoMeta is an object that contains all metadata of this YouTube video (thumbnail, title, author, views, etc.).

YtFile

After use getYTFiles() function, you will get SparseArray<YtFile> object. This object contains all available media files for one YouTube video, accessible by their itag value. You can get YtFile object by itag value like this:

var ytFiles = yt.getYTFiles()
var ytFile = ytFiles.get(251) // 251 is itag of audio
//Get stream URL
var streamUrl = ytFile?.url

VideoMeta

After use getVideoMeta() function, you will get VideoMeta object. This object contains all metadata of this YouTube video (thumbnail, title, author, views, etc.). You can get all metadata like this:

var videoMeta = yt.getVideoMeta()
    //title
    var title = videoMeta?.title
    //author
    var author = videoMeta?.author
    //view count
    var views = videoMeta?.viewCount
    //video length in second
    var videoLength = videoMeta?.videoLength
    //video channel id
    var videoChannelId = videoMeta?.channelId

//Get thumbnail
    // Default resolution
    val thumbUrl = videoMeta?.thumbUrl
    // 320 x 180
    val mqImageUrl = videoMeta?.mqImageUrl
    // 480 x 360
    val hqImageUrl = videoMeta?.hqImageUrl
    // 640 x 480
    val sdImageUrl = videoMeta?.sdImageUrl
    // Max Res
    val maxResImageUrl = videoMeta?.maxResImageUrl

Filter

To get list of only video YtFile or only audio, you can call this function

    val ytFiles = yt.getYtFile()
    val videoYtFiles = ytFiles.getAudioOnly() // Return ArrayList<YtFile> of only video
    val audioYtFiles = ytFiles.getVideoOnly() // Return ArrayList<YtFile> of only audio

To get best quality of video or audio, you can call this function

    val ytFiles = yt.getYtFile()
    val videoYtFiles = ytFiles.getAudioOnly()?.bestQuality() // Return best quality video
    val audioYtFiles = ytFiles.getVideoOnly()?.bestQuality() // Return best quality audio

Not working?

If you have any problem with this library, please create an issue. In my case:

• Can't get 1080p video with audio, you need to merge video and audio by yourself

List Itag and Format in this library:

I am trying to add more feature to this library. Keep in touch!!!

Dependency

• JsEvaluator (v6.0.0) - Running Javascript inside Android app

Donate

	paypal.me/maxraveofficial