NYoutubeDLP 0.13.0

.NET Core 3.1
dotnet add package NYoutubeDLP --version 0.13.0
NuGet\Install-Package NYoutubeDLP -Version 0.13.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NYoutubeDLP" Version="0.13.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NYoutubeDLP --version 0.13.0
#r "nuget: NYoutubeDLP, 0.13.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install NYoutubeDLP as a Cake Addin
#addin nuget:?package=NYoutubeDLP&version=0.13.0

// Install NYoutubeDLP as a Cake Tool
#tool nuget:?package=NYoutubeDLP&version=0.13.0

Thanks to Grumpy for upgrading the version to .NET Core 3.1

Works with youtube-dlp now after changing 2 lines. Current version has all the new options included as of the 2022.08.19 version of youtube-dlp, I intend to maintain the options with updates/fixes.

Reverted "CreateNoWindow" process parameter to True after significant testing.

Youtube-dlp can be found here: https://github.com/yt-dlp/yt-dlp

Github repo here: https://github.com/Antfere/NYoutubeDLP

All credit goes to the original Nyoutube-dl wrapper by Brian Allred which can be found on Gitlab here: https://gitlab.com/BrianAllred/NYoutubeDL

Usage is the exact same except you instantiate the class with "NyoutubeDLP();" like so:

    // Old way
    var youtubeDl = new YoutubeDL();
    // New way
    var youtubeDl = new YoutubeDLP();

Everything else including the "using NYoutubeDL;" statement are the same, you will just be using yt-dlp instead provided it is installed in your path or you point to it in your program directly.

If you need an option added, or need help with some functionality, please create an issue thread or pull request on github or contact me.

Every thing below this is the original readme from Nyoutube-dl which is probably still applicable for 99% of uses:


pipeline status

A simple youtube-dl library for C#.

See the main page for youtube-dl for more information.


Getting the package

Visual Studio
  • Search for NYoutubeDL in your project's NuGet Manager and click install.


  • In the NuGet package manager console, run

      PM> Install-Package NYoutubeDL
DotNet Core
  • In a terminal in your project's folder, run

      dotnet add package NYoutubeDL
  • Manually download nupkg from NuGet Gallery.

Using the code

See the documentation for youtube-dl first to understand what it does and how it does it.

  1. Create a new YoutubeDL client:

     var youtubeDl = new YoutubeDL();
  2. Options are grouped according to the youtube-dl documentation:

     youtubeDl.Options.FilesystemOptions.Output = "/path/to/downloads/video.mp4";
     youtubeDl.Options.PostProcessingOptions.ExtractAudio = true;
     youtubeDl.VideoUrl = "http://www.somevideosite.com/videoUrl";
     // Or update the binary
     youtubeDl.Options.GeneralOptions.Update = true;
     // Optional, required if binary is not in $PATH
     youtubeDl.YoutubeDlPath = "/path/to/youtube-dl";
  3. Options can also be saved and loaded. Only changed options will be saved.

     File.WriteAllText("options.config", youtubeDl.Options.Serialize());
     youtubeDl.Options = Options.Deserialize(File.ReadAllText("options.config"));
  4. Subscribe to the console output (optional, but recommended):

     youtubeDl.StandardOutputEvent += (sender, output) => Console.WriteLine(output);
     youtubeDl.StandardErrorEvent += (sender, errorOutput) => Console.WriteLine(errorOutput);
  5. Subscribe to download information updates. Hard subscription is optional, the DownloadInfo class implements INotifyPropertyChanged.

     youtubeDl.Info.PropertyChanged += delegate { <your code here> };
  6. Start the download:

     // Prepare the download (in case you need to validate the command before starting the download)
     string commandToRun = await youtubeDl.PrepareDownloadAsync();
     // Alternatively
     string commandToRun = youtubeDl.PrepareDownload();
      // Just let it run
     // Wait for it
     // Or provide video url

Workaround for IIS

There is a weird permissions issue that ocurrs when invoking youtube-dl from an ASP.NET/IIS process. In this case, perform the following steps

  1. Install Python on the server.

  2. Download and place the Python version of youtube-dl (not the executable binary) somewhere on the server. This can be found here.

  3. When creating the YoutubeDL client object, set the PythonPath property to the path of the Python executable binary and the YoutubeDlPath to the path of the python version of youtube-dl.

Reporting issues

While both youtube-dl itself and this library support many different services, my personal use centers around Youtube. If you find any bugs using this library with other services, feel free to raise an issue. Please provide a specific link/URL, if possible.


Pull requests for bug fixes are more than welcome! If you find and fix an issue, make a pull request with the bug and fix clearly described.

Pull requests for features will be considered, although I'm not sure what else this library needs to do. If you have an idea for a new feature, please raise an issue first in order to start a discussion. This saves both you and me time. I don't want anyone to code an elaborate feature and write up an immaculate pull request if it doesn't belong in this library.

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp3.1
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on NYoutubeDLP:

Repository Stars
Youtube Metadata Plugin for Jellyfin
Version Downloads Last updated
0.13.0 371 8/30/2022
0.12.2 253 8/27/2022
0.12.1 709 4/10/2022
0.12.0 297 3/5/2022
0.11.4 314 1/31/2022
0.11.3 304 1/24/2022
0.11.2 160 1/16/2022