Changelog

Changelog

This page tracks the release history of Ytdlp.NET, including major features, fixes, and breaking changes.

All versions are available on NuGet.

v2.0.0-preview1 (February 2026)

Initial public preview release – major rewrite and modernization

Major Features

• Fluent API with full chaining support (SetFormat, EmbedMetadata, UseProxy, etc.)
• Rich JSON metadata parsing via GetVideoMetadataJsonAsync
  → Metadata, FormatMetadata, ThumbnailMetadata, ChapterMetadata, etc.
• Auto-selection helpers:
  • GetBestAudioFormatIdAsync
  • GetBestVideoFormatIdAsync(maxHeight)
• Real-time progress parsing & events (OnProgressDownload, OnPostProcessingComplete)
• Improved cancellation handling (graceful, no ObjectDisposedException)
• Batch downloads (sequential + concurrent with maxConcurrency)
• Companion NuGet packages: Ytdlp.Stable.Build, Ytdlp.FFmpeg.Build, Ytdlp.FFprobe.Build, Ytdlp.Deno.Runtime
• SponsorBlock integration (RemoveSponsorBlock)
• Concurrent fragments (WithConcurrentFragments)
• Custom command support (AddCustomCommand) with validation
• Strongly-typed models (Format, Metadata) with convenience properties (IsVideo, IsAudio, BestThumbnailUrl, etc.)

Breaking Changes

• Renamed from older structure to Ytdlp.NET namespace
• VideoFormat → Format (with richer fields)
• Progress parsing moved to dedicated ProgressParser class
• Many methods now async-first (ExecuteAsync, GetFormatsDetailedAsync, etc.)

Fixes & Improvements

• Better error handling & logging
• Null-safe properties in metadata models
• Defensive cancellation (no "No process is associated" noise)
• Sanitized input & allowed custom flags with warning

Dependencies

• .NET 8.0 / .NET 9.0 multi-target
• Companion packages recommended for binaries

v1.x Series (Legacy – not recommended)

• Basic wrapper around yt-dlp
• Limited fluent API
• Text-based format parsing only
• No rich metadata, no best-format helpers, no concurrent batch
• Maintained until early 2026, then archived

Upgrade recommendation: All new projects should start with v2.0-preview1 or later.

Roadmap (post v2.0 stable)

• Playlist metadata & batch download enhancements
• UI-friendly progress reporting (WPF/MAUI integration examples)
• Automatic best-format presets (Best1080p, BestAudioOnly, Fastest)
• Cookie management helpers
• Live stream recording support
• Full DocFX / GitHub Pages API documentation

See also:

• Usage Examples
• Metadata Model
• Companion Packages

Last updated: February 15, 2026