Skip to content

Library for extracting url for downloading audio and video streams from YouTube videos

License

Notifications You must be signed in to change notification settings

tmk907/YouTubeStreamsExtractor

Repository files navigation

YouTubeStreamsExtractor

YouTubeStreamsExtractor is a library for extracting url for downloading audio and video streams from YouTube videos. It's inspired by yt-dlp

Install

Install YouTubeStreamsExtractor and one of the javascript engines or implement IJavaScriptEngine interface.

Version Package Description
Nuget YouTubeStreamsExtractor .NET 8 Library
Nuget YouTubeStreamsExtractor.JsEngine.JavaScriptEngineSwitcher javascript engine, .NET 8 Library
Nuget YouTubeStreamsExtractor.JsEngine.AndroidWebView javascript engine, .NET 8 Android Library

Usage

Get streams with playable urls

using YouTubeStreamsExtractor;
using YouTubeStreamsExtractor.JsEngine.JavaScriptEngineSwitcher;

IJavaScriptEngine jsEngine = new JavaScriptJintEngine();
var youTubeStreams = new YouTubeStreams(jsEngine);
var streams = await youTubeStreams.GetAllStreamsAsync(videoUrl, prepareAllUrls: true);

If you only need a URL for one stream, set prepareAllUrls to false and use PrepareAsync() method. It doesn't need to prepare the url for each stream, which makes it faster.

var streams = await youTubeStreams.GetAllStreamsAsync(url, prepareAllUrls: false);
var audio = streamSelector.SelectBestAudio(streams);
await audio.PlayableUrl.PrepareAsync(audio.RawUrl, youTubeStreams.Decryptor);

var downloadUrl = audio.PlayableUrl.Url;

Find audio with highest bitrate

var streamSelector = new StreamSelector();
var audio = streamSelector.SelectBestAudio(streams);

var downloadUrl = audio.PlayableUrl.Url;

Find videos that match specific resolutions and/or codecs.

This will return stream with highest bitrate that has resolution 1080p and codec vp9 or null if that stream is not available.

var streamSelector = new StreamSelector(new[] { "1080p" }, new[] { "vp9" });
IVideoStreamInfo? videoStream = streamSelector.SelectPreferredVideo(streams);

This will return 1080p stream with highest bitrate. If it is not available, then 1080p60, then 720p and 720p60.

var streamSelector = new StreamSelector(new[] { "1080p", "1080p60", "720p", "720p60" });
IVideoStreamInfo? videoStream = streamSelector.SelectPreferredVideo(streams);

YouTubeStreamsExtractor.JsEngine.JavaScriptEngineSwitcher

Uses JavaScript Engine Switcher with Jint, Jurassic and NiL.JS engines to execute js code.
This is the simplest implementation but sometimes it might not be able to execute js code to descramble 'n' parameter, which will result in throttled download speed.

YouTubeStreamsExtractor.JsEngine.AndroidWebView

Uses WebView to execute js code.

ExampleWinUI3App

WinUI3 example application uses WebView2 to execute javascript code.

About

Library for extracting url for downloading audio and video streams from YouTube videos

Topics

Resources

License

Stars

Watchers

Forks

Languages