From 86e5bacb1d8ea2fcf876557d72dbf37b89a3403c Mon Sep 17 00:00:00 2001 From: Ross Patterson Date: Thu, 21 Aug 2025 08:04:09 -0700 Subject: [PATCH] docs(faq): Clarify reasons to re-download files --- docs/source/faq/index.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/source/faq/index.rst b/docs/source/faq/index.rst index f548020b..b33a4b55 100644 --- a/docs/source/faq/index.rst +++ b/docs/source/faq/index.rst @@ -157,11 +157,14 @@ clever scraping mechanisms. ...force ytdl-sub to re-download a file ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Sometimes users may wish to replace a file already in the archive, for example, if the +current file is a lower resolution than desired, missing subtitles, corrupt, etc.. + ``ytdl-sub`` decides what files have already been downloaded by entries in :ref:`the download archive file `, ``./.ytdl-sub-...-download-archive.json``, at the top of the subscription/series/show :ref:`output directory ` in the appropriate -``overrides: / ..._directory:`` library path *and* the presence of the corresponding +``overrides: / ..._directory:`` library path, *and* the presence of the corresponding downloaded files under the same path. To force ``ytdl-sub`` to re-download an entry both need to be removed: