Skip to content

v0.5.3 - YouTube reliability + budget safeguards

Choose a tag to compare

@github-actions github-actions released this 12 Feb 11:46
· 71 commits to master since this release
v0.5.3

Added

  • Bleeding-edge YouTube 2026 support: Upgraded to yt-dlp 2026.02.04 with mandatory JS runtime helpers (yt-dlp-ejs, curl-cffi) and optimized player skip patterns for lower latency.
  • Visitor context binding: Added PO token, visitor data, and data sync ID configuration so tokens are bound to the correct session and avoid extraction failures.
  • Pre-download budget checks: YouTube metadata is fetched before download to reserve audio-seconds budget upfront and prevent wasted bandwidth.
  • Duration reconciliation: Post-download adjustments correct budget deltas when actual duration differs from estimates, including automatic release on download failures.

Changed

  • Source metadata model: Introduced SourceMetadata and updated AudioSourceProvider to support pre-flight metadata extraction.
  • Budget governor release flow: Added release() method and negative audio-seconds handling for compensating entries.
  • CLI setup: Added interactive prompts for YouTube PO tokens, visitor data, and JS runtime selection.
  • Documentation updates: README and docs updated for YouTube 2026 configuration and budget safeguards.

Fixed

  • Protocol conformance tests: Updated AudioSourceProvider mocks for get_metadata() and added coverage for release/reconciliation flows.