Closes Feature Request: https://github.com/jmbannon/ytdl-sub/issues/743 Subscriptions support using presets as keys, and using keys to set override variables as values. For example: ``` tv_show: only_recent: [News]: "Breaking News": "https://www.youtube.com/@SomeBreakingNews" [Tech]: "Two Minute Papers": "https://www.youtube.com/@TwoMinutePapers" ``` Will create two subscriptions named "Breaking News" and "Two Minute Papers", equivalent to: ``` "Breaking News": preset: - "tv_show" - "only_recent" overrides: subscription_indent_1: "News" subscription_name: "Breaking News" subscription_value: "https://www.youtube.com/@SomeBreakingNews" "Two Minute Papers": preset: - "tv_show" overrides: subscription_indent_1: "Tech" subscription_name: "Two Minute Papers" subscription_value: "https://www.youtube.com/@TwoMinutePapers" ``` You can provide as many parent presets in the form of keys, and subscription indents as ``[keys]``. This can drastically simplify subscription definitions by setting things you want configurable like so in your parent preset: ``` presets: tv_show_name: overrides: tv_show_name: "{subscription_name}" url: "{subscription_value}" genre: "{subscription_indent_1}" ``` NOTE!!! Changing your subscription name from 'legacy' subscriptions will need their download archive file migrated to a new name. A future update will assist in this migration process. Either wait until then or, if you consider yourself a ytdl-sub expert, keep a backup of your subscription file before migrating.
59 lines
1.2 KiB
ReStructuredText
59 lines
1.2 KiB
ReStructuredText
Deprecation Notices
|
|
===================
|
|
|
|
Oct 2023
|
|
--------
|
|
|
|
subscription preset and value
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
The use of ``__value__`` will go away in Dec 2023 in favor of the method found in
|
|
:ref:`beautifying subscriptions`. ``__preset__`` will still be supported for the time being.
|
|
|
|
July 2023
|
|
---------
|
|
|
|
music_tags
|
|
^^^^^^^^^^
|
|
|
|
Music tags are getting simplified. ``tags`` will now reside directly under music_tags, and
|
|
``embed_thumbnail`` is getting moved to its own plugin (supports video files as well). Convert from:
|
|
|
|
.. code-block:: yaml
|
|
|
|
my_example_preset:
|
|
music_tags:
|
|
embed_thumbnail: True
|
|
tags:
|
|
artist: "Elvis Presley"
|
|
|
|
To the following:
|
|
|
|
.. code-block:: yaml
|
|
|
|
my_example_preset:
|
|
embed_thumbnail: True
|
|
music_tags:
|
|
artist: "Elvis Presley"
|
|
|
|
The old format will be removed in October 2023.
|
|
|
|
video_tags
|
|
^^^^^^^^^^
|
|
|
|
Video tags are getting simplified as well. ``tags`` will now reside directly under video_tags.
|
|
Convert from:
|
|
|
|
.. code-block:: yaml
|
|
|
|
my_example_preset:
|
|
video_tags:
|
|
tags:
|
|
title: "Elvis Presley Documentary"
|
|
|
|
To the following:
|
|
|
|
.. code-block:: yaml
|
|
|
|
my_example_preset:
|
|
video_tags:
|
|
title: "Elvis Presley Documentary"
|