Skip to content

ytdl-sub

v2026.07.16 Feature

This release adds 1 notable feature for engineering teams evaluating rollout.

Published 11d Automation & Workflows
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

emby jellyfin kodi lidarr nfo plex
+7 more
radarr servarr sonarr youtube yt-dlp yt-dlp-wrapper ytdl

Summary

AI summary

Adds a keep_max_files_sort_by config option to control pruning order by upload_date or playlist_index.

Changes in this release

Feature Medium

Adds keep_max_files_sort_by config option to control pruning sort order

Adds keep_max_files_sort_by config option to control pruning sort order

Source: llm_adapter@2026-07-16

Confidence: high

 —
Feature Medium

Introduces fallback warning when sort_by is playlist_index but no indices exist

Introduces fallback warning when sort_by is playlist_index but no indices exist

Source: llm_adapter@2026-07-16

Confidence: high

 —
Feature Medium

Adds only_recent_sort_by preset support in download_deletion_options helper

Adds only_recent_sort_by preset support in download_deletion_options helper

Source: llm_adapter@2026-07-16

Confidence: high

 —
Feature Medium

Persists playlist_index on DownloadMapping for prune-time ordering

Persists playlist_index on DownloadMapping for prune-time ordering

Source: llm_adapter@2026-07-16

Confidence: low

 —
Feature Low

Persists `playlist_index` on `DownloadMapping` entries in archive JSON

Persists `playlist_index` on `DownloadMapping` entries in archive JSON

Source: granite4.1:30b@2026-07-16-audit

Confidence: low

 —
Full changelog

Add keep_max_files_sort_by option for playlist-index-based retention (#1484)

Adds a keep_max_files_sort_by config option that controls how entries are ordered when pruning with keep_max_files.

Previously, pruning always sorted by upload_date (keeping the most recent). This adds support for sorting by playlist_index (keeping the lowest indices), which is useful for playlists where position matters more than upload date e.g. keeping the first N episodes of a series.

Changes

  • keep_max_files_sort_by - new output_options field accepting "upload_date" (default, preserving existing behaviour) or "playlist_index"
  • playlist_index on DownloadMapping - persisted in the archive JSON so it's available at prune time; old archives without the field gracefully default to None
  • Fallback behaviour - if sort_by is "playlist_index" but no entries have an index (e.g. old archives), logs a warning and falls back to upload_date (current behaviour)
  • Prebuilt preset support - only_recent_sort_by override wired into the download_deletion_options helper

Closes #1461

Thanks @michaeldyrynda for the AAA PR! This is great stuff

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track ytdl-sub

Get notified when new releases ship.

Sign up free

About ytdl-sub

Lightweight tool to automate downloading and metadata generation with yt-dlp

All releases →

Related context

Beta — feedback welcome: [email protected]