docs(faq): Missing CLI ovrrides to re-download

This commit is contained in:
Ross Patterson 2025-08-20 22:05:03 -07:00
parent bcd25484d8
commit 9939cf9bad
No known key found for this signature in database
GPG key ID: 2EFF7CCE6828E359

View file

@ -182,7 +182,27 @@ need to be removed:
the downloaded files in this file and delete that whole entry, from the YouTube ID the downloaded files in this file and delete that whole entry, from the YouTube ID
string to the closing curly braces. Be ware of JSON traling commas. string to the closing curly braces. Be ware of JSON traling commas.
- Run ``$ ytdl-sub sub`` again. - Run ``$ ytdl-sub sub`` again with the appropriate CLI overrides:
Depending on the presets and overrides of the subscriptions whose downloaded files
you've renamed in the steps above, you need to pass some overrides from the command
line to tell ``ytdl-sub`` to change its behavior and re-download those files.
Most presets tell ``yt-dlp`` not to bother even looking at videos before the most
recently downloaded video :ref:`using 'break_on_existing'
<config_reference/plugins:ytdl_options>`. Other presets, such as :ref:`the Only Recent
presets <prebuilt_presets/helpers:only recent>`, restrict the videos considered for
download by date range.
Determine the necessary CLI overrides and re-run, for example:
.. code-block:: shell
ytdl-sub sub -o "\
--ytdl_options.break_on_existing False \
--date_range.after 19700101 \
--date_range.before 20380119 \
"
There is a bug where... There is a bug where...