YoutubeReExplode 7.3.0
dotnet add package YoutubeReExplode --version 7.3.0
NuGet\Install-Package YoutubeReExplode -Version 7.3.0
<PackageReference Include="YoutubeReExplode" Version="7.3.0" />
paket add YoutubeReExplode --version 7.3.0
#r "nuget: YoutubeReExplode, 7.3.0"
// Install YoutubeReExplode as a Cake Addin #addin nuget:?package=YoutubeReExplode&version=7.3.0 // Install YoutubeReExplode as a Cake Tool #tool nuget:?package=YoutubeReExplode&version=7.3.0
YoutubeReExplode
A continuation of YoutubeExplode, by Tyrrrz. Added a music extraction feature that I was personally missing in this package. Might add more features in the future. Extracted music data is available in the Video class returned by the YoutubeClient.
Original README:
YoutubeExplode
<table> <tr> <td width="99999" align="center">Development of this project is entirely funded by the community. <b><a href="https://tyrrrz.me/donate">Consider donating to support!</a></b></td> </tr> </table>
<p align="center"> <img src="favicon.png" alt="Icon" /> </p>
YoutubeExplode is a library that provides an interface to query metadata of YouTube videos, playlists and channels, as well as to resolve and download video streams and closed caption tracks. Behind a layer of abstraction, this library works by scraping raw page data and exploiting reverse-engineered internal endpoints.
π Interested in the inner workings of this library? See the Reverse-Engineering YouTube article.
Extension packages:
- YoutubeExplode.Converter β provides an interface to download and convert videos using FFmpeg
Terms of use<sup>[?]</sup>
By using this project or its source code, for any purpose and in any shape or form, you grant your implicit agreement to all the following statements:
- You condemn Russia and its military aggression against Ukraine
- You recognize that Russia is an occupant that unlawfully invaded a sovereign state
- You support Ukraine's territorial integrity, including its claims over temporarily occupied territories of Crimea and Donbas
- You reject false narratives perpetuated by Russian state propaganda
To learn more about the war and how you can help, click here. Glory to Ukraine! πΊπ¦
Install
- π¦ NuGet:
dotnet add package YoutubeExplode
Screenshots
Usage
YoutubeExplode exposes its functionality through a single entry point β the YoutubeClient
class.
Create an instance of this class and use the provided operations on Videos
, Playlists
, Channels
, and Search
properties to send requests.
Videos
Retrieving video metadata
To retrieve the metadata associated with a YouTube video, call Videos.GetAsync(...)
:
using YoutubeExplode;
var youtube = new YoutubeClient();
// You can specify either the video URL or its ID
var videoUrl = "https://youtube.com/watch?v=u_yIGGhubZs";
var video = await youtube.Videos.GetAsync(videoUrl);
var title = video.Title; // "Collections - Blender 2.80 Fundamentals"
var author = video.Author.ChannelTitle; // "Blender"
var duration = video.Duration; // 00:07:20
Downloading video streams
Every YouTube video has a number of streams available, differing in containers, video quality, bitrate, framerate, and other parameters. Additionally, the streams are further divided into 3 categories based on their content:
Muxed streams β contain both video and audio(no longer provided by YouTube)- Audio-only streams β contain only audio
- Video-only streams β contain only video
Warning: Muxed streams contain both audio and video, but these streams are limited in quality (up to 720p30). To download the video in the highest available quality, you will need to resolve the best audio-only and video-only streams separately and then mux them together. The muxing process can be performed using FFmpeg with the help of the YoutubeExplode.Converter package.
Warning: Muxed streams are deprecated by YouTube and are not guaranteed to be available for every video. If possible, avoid relying on them too much and instead perform muxing manually using the provided audio-only and video-only streams.
You can request the manifest that lists all available streams for a particular video by calling Videos.Streams.GetManifestAsync(...)
:
using YoutubeExplode;
var youtube = new YoutubeClient();
var videoUrl = "https://youtube.com/watch?v=u_yIGGhubZs";
var streamManifest = await youtube.Videos.Streams.GetManifestAsync(videoUrl);
Once the manifest is obtained, you can filter through the streams and identify the ones you're interested in:
using YoutubeExplode;
using YoutubeExplode.Videos.Streams;
// ...
// Get the highest bitrate audio-only stream
var streamInfo = streamManifest.GetAudioOnlyStreams().GetWithHighestBitrate();
// ...or the highest quality MP4 video-only stream
var streamInfo = streamManifest
.GetVideoOnlyStreams()
.Where(s => s.Container == Container.Mp4)
.GetWithHighestVideoQuality()
Finally, you can resolve the actual stream represented by the specified metadata using Videos.Streams.GetAsync(...)
or download it directly to a file with Videos.Streams.DownloadAsync(...)
:
// ...
// Get the actual stream
var stream = await youtube.Videos.Streams.GetAsync(streamInfo);
// Download the stream to a file
await youtube.Videos.Streams.DownloadAsync(streamInfo, $"video.{streamInfo.Container}");
Warning: While the
Url
property in the stream metadata can be used to access the underlying content, you need a series of carefully crafted HTTP requests in order to do so. It's highly recommended to useVideos.Streams.GetAsync(...)
orVideos.Streams.DownloadAsync(...)
instead, as they will perform all the heavy lifting for you.
Downloading closed captions
Closed captions can be downloaded in a similar way to media streams.
To get the list of available closed caption tracks, call Videos.ClosedCaptions.GetManifestAsync(...)
:
using YoutubeExplode;
var youtube = new YoutubeClient();
var videoUrl = "https://youtube.com/watch?v=u_yIGGhubZs";
var trackManifest = await youtube.Videos.ClosedCaptions.GetManifestAsync(videoUrl);
Then retrieve the metadata for a particular track:
// ...
// Find closed caption track in English
var trackInfo = trackManifest.GetByLanguage("en");
Finally, use Videos.ClosedCaptions.GetAsync(...)
to get the actual content of the track:
// ...
var track = await youtube.Videos.ClosedCaptions.GetAsync(trackInfo);
// Get the caption displayed at 0:35
var caption = track.GetByTime(TimeSpan.FromSeconds(35));
var text = caption.Text; // "collection acts as the parent collection"
You can also download the closed caption track in the SRT file format with Videos.ClosedCaptions.DownloadAsync(...)
:
// ...
await youtube.Videos.ClosedCaptions.DownloadAsync(trackInfo, "cc_track.srt");
Playlists
Retrieving playlist metadata
You can get the metadata associated with a YouTube playlist by calling the Playlists.GetAsync(...)
method:
using YoutubeExplode;
var youtube = new YoutubeClient();
var playlistUrl = "https://youtube.com/playlist?list=PLa1F2ddGya_-UvuAqHAksYnB0qL9yWDO6";
var playlist = await youtube.Playlists.GetAsync(playlistUrl);
var title = playlist.Title; // "First Steps - Blender 2.80 Fundamentals"
var author = playlist.Author.ChannelTitle; // "Blender"
Retrieving videos included in a playlist
To get the videos included in a playlist, call Playlists.GetVideosAsync(...)
:
using YoutubeExplode;
using YoutubeExplode.Common;
var youtube = new YoutubeClient();
var playlistUrl = "https://youtube.com/playlist?list=PLa1F2ddGya_-UvuAqHAksYnB0qL9yWDO6";
// Get all playlist videos
var videos = await youtube.Playlists.GetVideosAsync(playlistUrl);
// Get only the first 20 playlist videos
var videosSubset = await youtube.Playlists.GetVideosAsync(playlistUrl).CollectAsync(20);
You can also enumerate the videos iteratively without waiting for the whole list to load:
using YoutubeExplode;
var youtube = new YoutubeClient();
var playlistUrl = "https://youtube.com/playlist?list=PLa1F2ddGya_-UvuAqHAksYnB0qL9yWDO6";
await foreach (var video in youtube.Playlists.GetVideosAsync(playlistUrl))
{
var title = video.Title;
var author = video.Author;
}
If you need precise control over how many requests you send to YouTube, use Playlists.GetVideoBatchesAsync(...)
which returns videos wrapped in batches:
using YoutubeExplode;
var youtube = new YoutubeClient();
var playlistUrl = "https://youtube.com/playlist?list=PLa1F2ddGya_-UvuAqHAksYnB0qL9yWDO6";
// Each batch corresponds to one request
await foreach (var batch in youtube.Playlists.GetVideoBatchesAsync(playlistUrl))
{
foreach (var video in batch.Items)
{
var title = video.Title;
var author = video.Author;
}
}
Note: You can craft playlist IDs to fetch special auto-generated playlists, such as music mixes, popular channel uploads, liked videos, and more. See this reference for more information.
Channels
Retrieving channel metadata
You can get the metadata associated with a YouTube channel by calling the Channels.GetAsync(...)
method:
using YoutubeExplode;
var youtube = new YoutubeClient();
var channelUrl = "https://youtube.com/channel/UCSMOQeBJ2RAnuFungnQOxLg";
var channel = await youtube.Channels.GetAsync(channelUrl);
var title = channel.Title; // "Blender"
You can also get the channel metadata by username or profile URL with Channels.GetByUserAsync(...)
:
using YoutubeExplode;
var youtube = new YoutubeClient();
var channelUrl = "https://youtube.com/user/BlenderFoundation";
var channel = await youtube.Channels.GetByUserAsync(channelUrl);
var id = channel.Id; // "UCSMOQeBJ2RAnuFungnQOxLg"
To get the channel metadata by slug or legacy custom URL, use Channels.GetBySlugAsync(...)
:
using YoutubeExplode;
var youtube = new YoutubeClient();
var channelUrl = "https://youtube.com/c/BlenderFoundation";
var channel = await youtube.Channels.GetBySlugAsync(channelUrl);
var id = channel.Id; // "UCSMOQeBJ2RAnuFungnQOxLg"
To get the channel metadata by handle or custom URL, use Channels.GetByHandleAsync(...)
:
using YoutubeExplode;
var youtube = new YoutubeClient();
var channelUrl = "https://youtube.com/@BeauMiles";
var channel = await youtube.Channels.GetByHandleAsync(channelUrl);
var id = channel.Id; // "UCm325cMiw9B15xl22_gr6Dw"
Retrieving channel uploads
To get the list of videos uploaded by a channel, call Channels.GetUploadsAsync(...)
:
using YoutubeExplode;
using YoutubeExplode.Common;
var youtube = new YoutubeClient();
var channelUrl = "https://youtube.com/channel/UCSMOQeBJ2RAnuFungnQOxLg";
var videos = await youtube.Channels.GetUploadsAsync(channelUrl);
Search
You can execute a search query by calling the Search.GetResultsAsync(...)
method.
Each search result may represent either a video, a playlist, or a channel, so you need to apply pattern matching to handle the corresponding cases:
using YoutubeExplode;
var youtube = new YoutubeClient();
await foreach (var result in youtube.Search.GetResultsAsync("blender tutorials"))
{
// Use pattern matching to handle different results (videos, playlists, channels)
switch (result)
{
case VideoSearchResult video:
{
var id = video.Id;
var title = video.Title;
var duration = video.Duration;
break;
}
case PlaylistSearchResult playlist:
{
var id = playlist.Id;
var title = playlist.Title;
break;
}
case ChannelSearchResult channel:
{
var id = channel.Id;
var title = channel.Title;
break;
}
}
}
To limit the results to a specific type, use Search.GetVideosAsync(...)
, Search.GetPlaylistsAsync(...)
, or Search.GetChannelsAsync(...)
:
using YoutubeExplode;
using YoutubeExplode.Common;
var youtube = new YoutubeClient();
var videos = await youtube.Search.GetVideosAsync("blender tutorials");
var playlists = await youtube.Search.GetPlaylistsAsync("blender tutorials");
var channels = await youtube.Search.GetChannelsAsync("blender tutorials");
Similarly to playlists, you can also enumerate results in batches by calling Search.GetResultBatchesAsync(...)
:
using YoutubeExplode;
var youtube = new YoutubeClient();
// Each batch corresponds to one request
await foreach (var batch in youtube.Search.GetResultBatchesAsync("blender tutorials"))
{
foreach (var result in batch.Items)
{
switch (result)
{
case VideoSearchResult videoResult:
{
// ...
}
case PlaylistSearchResult playlistResult:
{
// ...
}
case ChannelSearchResult channelResult:
{
// ...
}
}
}
}
Authentication
You can access private videos and playlists by providing cookies that correspond to a pre-authenticated YouTube account.
To do that, create an instance of YoutubeClient
using a constructor that accepts IReadOnlyList<Cookie>
:
using YoutubeExplode;
// Perform authentication and extract cookies
var cookies = ...;
// Cookie collection must be of type IReadOnlyList<System.Net.Cookie>
var youtube = new YoutubeClient(cookies);
In order to actually perform the authentication, you can use an embedded browser such as WebView to navigate the user to the YouTube login page, let them log in, and then extract the cookies from the browser.
Etymology
The "Explode" in YoutubeExplode comes from the name of a PHP function that splits up strings, explode(...)
. When I was starting the development of this library, most of the reference source code I read was written in PHP, hence the inspiration for the name.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- AngleSharp (>= 1.1.2)
- Microsoft.Bcl.AsyncInterfaces (>= 9.0.0)
- System.Text.Json (>= 9.0.0)
- System.Threading.Tasks.Extensions (>= 4.6.0)
-
net9.0
- AngleSharp (>= 1.1.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
7.3.0 | 78 | 12/13/2024 |
7.2.4 | 99 | 11/17/2024 |
7.2.3 | 76 | 11/16/2024 |
7.2.2 | 123 | 10/2/2024 |
7.2.0 | 146 | 8/8/2024 |
7.1.14 | 120 | 5/27/2024 |
7.1.13 | 104 | 5/27/2024 |
7.1.12 | 131 | 4/27/2024 |
7.1.11 | 162 | 2/22/2024 |
7.1.10 | 140 | 1/19/2024 |
7.1.9 | 118 | 1/19/2024 |
7.1.8 | 142 | 12/28/2023 |
7.1.7 | 114 | 12/28/2023 |
7.1.6 | 136 | 12/28/2023 |
7.1.5 | 186 | 11/18/2023 |
7.1.4 | 184 | 10/24/2023 |
7.1.3 | 157 | 9/30/2023 |
7.1.2 | 186 | 9/7/2023 |
7.1.1 | 207 | 8/20/2023 |
7.1.0 | 180 | 8/6/2023 |
7.0.8 | 203 | 7/1/2023 |
7.0.7 | 214 | 6/8/2023 |
7.0.6 | 212 | 5/3/2023 |
7.0.5 | 245 | 4/28/2023 |
7.0.4 | 281 | 3/31/2023 |
7.0.3 | 255 | 3/26/2023 |
7.0.2 | 289 | 3/20/2023 |
7.0.1 | 258 | 3/14/2023 |
7.0.0 | 291 | 3/6/2023 |
6.2.8 | 301 | 3/2/2023 |
6.2.6 | 297 | 2/21/2023 |