Deprecation Notices

Deprecation Notices#

Dec 2025#

Override variables names can no longer be plugin names, to avoid the common pitfall of defining a plugin underneath overrides.

In the past, there was usage of a date_range override variable in a few example configs that complimented the Only Recent preset. This overrride variable usage needs to be replaced with only_recent_date_range.

Sep 2024#

regex plugin#

Regex plugin has been removed in favor of scripting. The function regex_capture_many has been created to replicate the plugin’s behavior. See the following converted example:

regex plugin#
  regex:
    from:
      title:
        match:
          - ".*? - (.*)"  # Captures 'Some - Song' from 'Emily Hopkins - Some - Song'
        capture_group_names:
          - "captured_track_title"
        capture_group_defaults:
          - "{title}"
  overrides:
    track_title: "{captured_track_title}"
scripting#
  overrides:
    # Captures 'Some - Song' from 'Emily Hopkins - Some - Song'
    captured_track_title: >-
      {
        %regex_capture_many(
          title,
          [ ".*? - (.*)" ],
          [ title ]
        )
      }
    track_title: "{%array_at(captured_track_title, 1)}"

Oct 2023#

subscription preset and value#

The use of __value__ will go away in Dec 2023 in favor of the method found in Subscription File. __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:

my_example_preset:
  music_tags:
    embed_thumbnail: True
    tags:
      artist: "Elvis Presley"

To the following:

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:

my_example_preset:
  video_tags:
    tags:
      title: "Elvis Presley Documentary"

To the following:

my_example_preset:
  video_tags:
    title: "Elvis Presley Documentary"