Skip to content

YTMDL v0.28.0

Choose a tag to compare

@github-actions github-actions released this 20 Sep 18:08
· 213 commits to main since this release

YTMDL v0.28.0

Highlights

  • Update Channels: Administrators can choose between Stable (regular releases only, default for existing and new installations) and Development (explicitly published prereleases) in the update settings and web interface. ytmdlctl supports channel selection and SemVer 2.0.0 comparison with prerelease precedence.
  • Provider & Download Reliability: Reduced provider request volume through bounded metadata caching, candidate resolution deduplication, escalated YouTube rate-limit backoffs, and non-blocking DRM handling for SoundCloud items.
  • Audio Stream Classification: HLS audio renditions whose codec is reported as unknown are accepted and probed; combined audio/video streams are never filed as audio, while embedded cover art remains supported.
  • Age-Gate & Session Protection: YouTube age restrictions ("Sign in to confirm your age", "Verify your age") and unavailable videos are treated as candidate failures rather than session authorization failures. Healthy media sessions remain active without transitioning to AUTH_FAILED, while genuine auth failures and bot challenges preserve systemic protections.
  • Failed Job Error Visibility: Failure reasons from failed download items are propagated directly to parent jobs in the API and displayed in the Downloads UI (JobCard), replacing generic failure labels with actionable error details.
  • Discovered Release Deduplication: Equivalent provider catalog entries for the same release are deduplicated during artist scanning and discovery, preventing redundant download jobs that collide on canonical library storage paths.

Changes

  • Update System: PUT /api/v1/system/update/channel stores the preferred channel; update status reports channel, prerelease badges, and recommended ytmdlctl commands. An installed version newer than the channel offers is never downgraded.
  • ytmdlctl: check and update accept --channel stable|development and --target <version>. Manifest v3 is maintained for stable releases to preserve backward compatibility with installed CLI tooling.
  • Downloads & Diagnostics: The hourly throughput summary log line reports acquisitions, provider requests, reuse, rate limits, cooldown time, and failure reasons.
  • Web UI: Downloads view displays root item error messages on failed job cards with graceful fallback for historical jobs without parent error metadata.

Updates

Existing installations can update using:

ytmdlctl update

No database migration is required.

Full Changelog: v0.27.2-rc.2...v0.28.0