[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.
#
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__:
overrides:
# 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
music_directory: "/music"
music_directory: "/media/Library/Music"
# 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
# only_recent_date_range: "2months"

View file

@ -15,7 +15,7 @@ Below is a common configuration:
:linenos:
configuration:
working_directory: '/mnt/ssd/.ytdl-sub-downloads'
working_directory: "/media/Library/tmp/.ytdl-sub-working-directory"
presets:
TV Show:
@ -37,7 +37,7 @@ Below is a common configuration:
max: 36
overrides:
tv_show_directory: "/ytdl_sub_tv_shows"
tv_show_directory: "/media/Library/Videos/Series"
TV Show Only Recent:
preset:
@ -49,13 +49,17 @@ Configuration Section
---------------------
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
:lineno-start: 1
configuration:
working_directory: '/mnt/ssd/.ytdl-sub-downloads'
working_directory: "/media/Library/tmp/.ytdl-sub-working-directory"
Preset Section