danvics/ytdl-sub
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

first download

Browse source
This commit is contained in:
Jesse Bannon 2024-11-30 07:41:54 -08:00
parent 5e5b108851
commit a77f1beb77
3 changed files with 31 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
docs/source/guides/getting_started/first_download.rst
View file

@ -1,32 +1,39 @@
Initial Download Initial Download
================ ================
Once you have a ``subscriptions.yaml`` file created and filled out, you can perform your first Once you have a ``subscriptions.yaml`` file created, you can perform your first
download. Access ``ytdl-sub``, navigate to the directory containing your ``subscriptions.yaml`` download. Access ``ytdl-sub``, navigate to the directory containing your ``subscriptions.yaml``
file, then run the below command: file.
.. tab-set:: Dry Run
-------
.. tab-item:: Dry run Performing a dry run is important when applying any change to your subscriptions to
ensure output looks as expected. Dry runs will pull metadata to *simulate* a download
A dry run lets you check that your configuration doesn't throw any errors and what the expected output files of actually doing the download are, without actually downloading the full media. without actually downloading the media file.
.. code-block:: shell .. code-block:: shell
ytdl-sub --dry-run sub ytdl-sub --dry-run sub subscriptions.yaml
.. tab-item:: Normal run Faster Iteration Cycle
----------------------
A normal run will download all files as determined by your ``presets`` and, once processing is finished, move the downloaded and processed files to your ``output_directory``. Testing subscriptions can take quite some time to perform a full download.
This can be speed up by applying an override via command-line to set max number
of downloads.
.. code-block:: shell .. code-block:: shell
ytdl-sub sub ytdl-sub --dry-run sub subscriptions.yaml -o '--ytdl_options.max_downloads 3'
.. tab-item:: One-time download Having many subscriptions could still make this dry run take a while. A subset of
subscriptions can be dry ran using a match.
Sometimes you may only want to download media once, in which case adding them to your ``subscriptions.yaml`` file is unneccessary. As an example, the below code will download the same videos as our subscription file:
.. code-block:: shell .. code-block:: shell
ytdl-sub dl --preset "Jellyfin TV Show by Date" --overrides.subscription_name "NOVA PBS" --overrides.subscription_value "https://www.youtube.com/@novapbs" --overrides.tv_show_genre "Documentaries" :caption: Only run subscriptions that have PBS in their names
ytdl-sub --dry-run sub subscriptions.yaml -o '--ytdl_options.max_downloads 3' --match PBS
Downloading
-----------
WIP

6
docs/source/guides/getting_started/first_sub.rst
View file

@ -48,6 +48,12 @@ can set modifications that apply to every subscription in this file.
This snippet specifically adds two :ref:`override <config_reference/plugins:Overrides>` variables, This snippet specifically adds two :ref:`override <config_reference/plugins:Overrides>` variables,
which are used by the presets below. which are used by the presets below.
.. note::
It is tempting to put any override underneath ``overrides``. Keep in mind that this section
is solely for variable defining. Other :ref:`plugins <config_reference/plugins:Plugins>` need to be
set at the same indentation level as ``overrides``, not within it.
------------------------------------- -------------------------------------
.. code-block:: yaml .. code-block:: yaml

2
docs/source/guides/getting_started/index.rst
View file

@ -25,7 +25,7 @@ Terminology
Must-know terminology: Must-know terminology:
- ``subscription``: URL(s) that you want to download with specific metadata requirements. - ``subscription``: URL(s) that you want to download with specific metadata requirements.
- ``preset``: Reusable YAML configuration, that can specify anything from metadata layout, media quality, or any feature of ytdl-sub, to apply to subscriptions. A preset can inherit other presets. - ``preset``: A media profile comprised of YAML configuration that can specify anything from metadata layout, media quality, or any feature of ytdl-sub, to apply to subscriptions. A preset can inherit other presets.
- ``prebuilt preset``: Presets that are included in ytdl-sub. These do most of the work defining plugins, overrides, etc in order to make downloads ready for player consumption. - ``prebuilt preset``: Presets that are included in ytdl-sub. These do most of the work defining plugins, overrides, etc in order to make downloads ready for player consumption.
- ``override``: Verb describing the act of overriding something in a preset. For example, the TV Show presets practically expect you to *override* the URL variable to tell ytdl-sub where to download from. - ``override``: Verb describing the act of overriding something in a preset. For example, the TV Show presets practically expect you to *override* the URL variable to tell ytdl-sub where to download from.
- ``override variables``: User-defined variables that are intended to *override* something. - ``override variables``: User-defined variables that are intended to *override* something.