Releases · jmbannon/ytdl-sub

In the inspection output, we check function's return types via issubclass to see if an optimization can be made. Guard against this check in case the return type isn't a class -- it could be a Union[..., ...] from a conditional.

Assets 5

13 Apr 17:15

github-actions

2026.04.13.post1

970c74b

ytdl-sub 2026.04.13.post1

[FEATURE] inspect subcommand (#1407)

Subscription file syntax is designed to minimize boiler-plate when authoring new subscriptions.
You can now unpack any subscription using the inspect sub-command to see its boiler-plate preset format.

ytdl-sub inspect --config /path/to/config.yaml --match "BBC News" /path/to/subscriptions.yaml

This can be utilized for numerous purposes including:

Ensuring your custom preset is getting applied correctly.
Figuring out which variables set things like file names, metadata, etc.
Understanding how subscription syntax translates to preset representation.

The default --level of inspect will fill in defined variables. Using --level original will present the subscription's raw layout with no fill.

Assets 5

19 Mar 04:21

github-actions

2026.03.19

52a1cea

ytdl-sub 2026.03.19

Bump yt-dlp[default] from 2026.3.13 to 2026.3.17 (#1454)

Bumps yt-dlp[default] from 2026.3.13 to 2026.3.17.

updated-dependencies:

dependency-name: yt-dlp[default]
dependency-version: 2026.3.17
dependency-type: direct:production
update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] support@github.com
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Assets 5

13 Mar 20:39

github-actions

2026.03.13

a6aea03

ytdl-sub 2026.03.13

Bump yt-dlp[default] from 2026.3.3 to 2026.3.13 (#1450)

Bumps yt-dlp[default] from 2026.3.3 to 2026.3.13.

updated-dependencies:

dependency-name: yt-dlp[default]
dependency-version: 2026.3.13
dependency-type: direct:production
update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] support@github.com
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Assets 5

09 Mar 18:46

github-actions

2026.03.09.post3

0983a59

ytdl-sub 2026.03.09.post3

Update pytest requirement from <9.0,>=7.2 to >=7.2,<10.0 (#1380)

Updates the requirements on pytest to permit the latest version.

updated-dependencies:

dependency-name: pytest
dependency-version: 9.0.0
dependency-type: direct:development
...

Signed-off-by: dependabot[bot] support@github.com
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Assets 5

09 Mar 16:32

github-actions

2026.03.09

ff66ff5

ytdl-sub 2026.03.09

fix(docker): Add default crontab download command (#1321)

docs(docker): Recommended image DEFAULT_WORKSPACE
fix(docker): Add default crontab download command

Clarify the /config/ytdl-sub-configs/cron script with explanatory comments and a
default --dry-run command. Also change the wrapper script to echo commands for easier
debugging. To update an existing script, move the old script aside, restart the
container to regenerate it, and edit the new script.

Also clarify the Automating page in the Getting Started guide docs.

fix(docker): Unintentional unattended dry runs

PR feedback
prompted me to reconsider having a default command at all. We should assume,
unfortunately, that many new users will just skim the docs enough to enable the image's
cron integration but not actually incrementally test their configuration. In those
cases, they'd end up sending dry-run non-download requests for all their subscriptions
every 6 hours for no good reason. There's just no way to provide a default command that
isn't also providing a footgun.