[DOCS]: Large file long cross-device renames (#1301)

From [Discord discussion](https://discord.com/channels/994270357957648404/994270357957648408/1408832178623741993).
This commit is contained in:
Ross Patterson 2025-08-24 07:55:16 -07:00 committed by GitHub
parent f729efad52
commit 8eb5215a0c
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 15 additions and 8 deletions

View file

@ -16,4 +16,7 @@
# See the documentation above on how to build your own custom presets. # See the documentation above on how to build your own custom presets.
# #
configuration: configuration:
working_directory: ".ytdl-sub-working-directory" # Avoid unnecessarily long large file renames, set this to a path on the same
# filesystem as the destination for downloaded files in the `overrides: /
# *_directory:` paths:
working_directory: "/media/Library/tmp/.ytdl-sub-working-directory"

View file

@ -6,13 +6,13 @@
__preset__: __preset__:
overrides: overrides:
# Root folder of all ytdl-sub TV Shows # Root folder of all ytdl-sub TV Shows
tv_show_directory: "/tv_shows" tv_show_directory: "/media/Library/Videos/Series"
# Root folder of all ytdl-sub Music # Root folder of all ytdl-sub Music
music_directory: "/music" music_directory: "/media/Library/Music"
# Root folder of all ytdl-sub Music Videos # Root folder of all ytdl-sub Music Videos
music_video_directory: "/music_videos" music_video_directory: "/media/Library/Videos/Music"
# For 'Only Recent' preset, only keep vids within this range and limit # For 'Only Recent' preset, only keep vids within this range and limit
# only_recent_date_range: "2months" # only_recent_date_range: "2months"

View file

@ -15,7 +15,7 @@ Below is a common configuration:
:linenos: :linenos:
configuration: configuration:
working_directory: '/mnt/ssd/.ytdl-sub-downloads' working_directory: "/media/Library/tmp/.ytdl-sub-working-directory"
presets: presets:
TV Show: TV Show:
@ -37,7 +37,7 @@ Below is a common configuration:
max: 36 max: 36
overrides: overrides:
tv_show_directory: "/ytdl_sub_tv_shows" tv_show_directory: "/media/Library/Videos/Series"
TV Show Only Recent: TV Show Only Recent:
preset: preset:
@ -49,13 +49,17 @@ Configuration Section
--------------------- ---------------------
The :ref:`configuration <config_reference/config_yaml:Configuration File>` section sets The :ref:`configuration <config_reference/config_yaml:Configuration File>` section sets
options for ytdl-sub execution. options for ytdl-sub execution. Most users should set the path where ``ytdl-sub``
temporarily stores downloaded data before assembling it and moving it into your
library. To avoid unnecessarily long large file renames, use a path on the same
filesystem as your library in the ``overrides: / *_directory:`` paths:
.. code-block:: yaml .. code-block:: yaml
:lineno-start: 1 :lineno-start: 1
configuration: configuration:
working_directory: '/mnt/ssd/.ytdl-sub-downloads' working_directory: "/media/Library/tmp/.ytdl-sub-working-directory"
Preset Section Preset Section