/youtube-subtitles-extractor

This is the library to retrieve subtitles from a given YouTube video, inspired by https://github.com/devhims/youtube-caption-extractor

Primary LanguageC#MIT LicenseMIT

Icon YouTube Subtitles Extractor

Build and Test downloads version

This is the NuGet package library that retrieves subtitles from a given YouTube video, inspired by @devhims' YouTube Caption Extractor.

Known Issues

  • If you use this library on your Blazor WebAssembly project, you might encounter the CORS error. The only workaround is to use a facade API to retrieve the subtitles.

Getting Started

  1. Install the NuGet package to your project.

  2. Add the namespace to your code.

    using Aliencube.YouTubeSubtitlesExtractor;

  3. Get the YouTube video URL.

    var youtubeUrl = "https://www.youtube.com/watch?v=i8tMiWHK05M";

  4. Create an instance of YouTubeVideo class.

    var http = new HttpClient();
var youtube = new YouTubeVideo(http);

  5. Extract subtitles from the given YouTube video URL. There are a few options to extract subtitles.

    // Extract a single subtitle from the given YouTube video URL.
// - defaults to English (en)
var subtitle = await youtube.ExtractSubtitleAsync(youtubeUrl);

// Extract a single subtitle from the given YouTube video URL with the specified language code.
// eg) Korean (ko)
var subtitle = await youtube.ExtractSubtitleAsync(youtubeUrl, "ko");

// Extract list of subtitles from the given VideoOptions instance.
// eg) English and Korean (ko)
var options = new VideoOptions { Url = youtubeUrl, LanguageCodes = { "en", "ko" } };
var subtitles = await youtube.ExtractSubtitlesAsync(options);

Issues or Feedbacks

Please leave any issues or feedbacks on the GitHub Issue page.

TO-DOs

  • Extract YouTube video details including title, description and available subtitle languages.
  • List of available subtitle languages.

Acknowledgments