YouTubeStreamDownloader 1.1.9

YouTubeStreamDownloader 🎬

YouTubeStreamDownloader is a .NET 8 package that allows developers to interact with YouTube.
It provides functionality to retrieve video metadata, download videos, extract audio, get subtitles, and fetch playlist & channel details using the YoutubeExplode library.

🚀 Features

✅ Retrieve Video Metadata (title, duration, author, etc.)
✅ Download YouTube Videos (highest quality available)
✅ Extract & Download Subtitles (SRT format)
✅ Fetch Playlists & Channel Videos
✅ Supports Dependency Injection (DI)

📦 Installation

You can install YouTubeStreamDownloader via NuGet:

dotnet add package YouTubeStreamDownloader

OR via Package Manager:

Install-Package YouTubeStreamDownloader

🔥 Quick Start

1️⃣ Retrieve Video Metadata

IYouTubeMetadataService downloader = new YouTubeMetadataService(new YoutubeClient());
var video = await downloader.GetVideoInfoAsync(TEST_VIDEO_URL);

Console.WriteLine($"Title: {video.Title}");
Console.WriteLine($"Duration: {video.Duration}");
Console.WriteLine($"Author: {video.Author}");

2️⃣ Download YouTube Video

IYouTubeMetadataService downloader = new YouTubeMetadataService(new YoutubeClient());
var outputPath = "C:\\Videos";
string filePath = await downloader.DownloadVideoAsFileAsync(TEST_VIDEO_URL, outputPath);
Console.WriteLine($"Video downloaded successfully: {filePath}");

3️⃣ Fetch All Playlists from a Channel

using Microsoft.Extensions.DependencyInjection;
using YouTubeStreamDownloader.Services;

var services = new ServiceCollection();
services.AddYouTubeMetadataService();
var provider = services.BuildServiceProvider();

var metadataService = provider.GetRequiredService<IYouTubeMetadataService>();

var playlists = await metadataService.GetAllPlaylistsAsync("https://www.youtube.com/@YourChannel");

foreach (var playlist in playlists)
{
    Console.WriteLine($"{playlist.Title}: {playlist.Url}");
}

4️⃣ Fetch All Videos from a Playlist

using Microsoft.Extensions.DependencyInjection;
using YouTubeStreamDownloader.Services;

var provider = new ServiceCollection()
    .AddYouTubeMetadataService()
    .BuildServiceProvider();

var metadataService = provider.GetRequiredService<IYouTubeMetadataService>();

var videos = await metadataService.GetAllVideosFromPlaylistAsync("https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID");

foreach (var video in videos)
{
    Console.WriteLine($"{video.Title}: {video.Url}");
}

🏗 Dependency Injection (DI)

To use YouTubeStreamDownloader in an ASP.NET Core or Console Application, register it in Program.cs:

using Microsoft.Extensions.DependencyInjection;
using YouTubeStreamDownloader.Services;

var builder = WebApplication.CreateBuilder(args);

// Register the service
builder.Services.AddYouTubeMetadataService();

var app = builder.Build();

For Singleton DI:

builder.Services.AddYouTubeMetadataSingletonService();

🧪 Unit Testing

Unit tests use NSubstitute for mocking and FluentAssertions for validation.

Run all tests:

dotnet test

💡 Roadmap

• Audio-only downloads
• Download progress tracking
• Convert video format (MP4, MP3)
• Multi-threaded downloads
• User authentication for private videos
• YouTube Live Stream support

🤝 Contributing

Want to contribute?

Follow these steps:

1. Fork the repository.
2. Clone your fork:

   git clone https://github.com/your-username/YouTubeStreamDownloader.git
   

3. Create a new branch:

   git checkout -b feature/your-feature-name
   

4. Make changes and commit:

   git commit -m "Added new feature"
   

5. Push to your fork:

   git push origin feature/your-feature-name
   

6. Create a Pull Request (PR).

📝 License

YouTubeStreamDownloader is licensed under the MIT License.

📌 Contact

👤 Author: Shady Nagy
📧 Email: info@ShadyNagy.com
📌 GitHub: ShadyNagy
🌍 Website: https://shadynagy.com