search

PCJones / radarr-sonarr-german-dual-language

Guide on how to prefer German + English dual language in Radarr and Sonarr
MIT License
223 stars 14 forks source link

readme

Radarr & Sonarr German Dual Language Quality Profiles & Custom Formats Guide

This guide outlines how to configure and fully automate Radarr and Sonarr to prefer German + English dual releases.

Last Updated: 2024-05-30

Deutsche Anleitung

Table of Contents

Contributing

If you have questions, problems or improvements don't hesitate to create an issue or pull request!

Important Note

This setup requires Sonarr v4 Beta. Sonarr v3 will not work. However, Sonarr v4 Beta is quite stable and should cause few, if any, problems.

General Information

To reliably find German + English Dual Language releases (from now on referred to as "German DL" as the German Scene refers to them), it's best to have an indexer that specializes in these types of releases.

I don't want dual language, I want to prefer German but use English as fallback (or vice versa)

No problem at all! Just follow every step in the guide but skip every step about the "German DL" custom format. At Prefer Language import the one that fits your setup and then remove the "NOT German DL" condition before saving. Sorry if this sounds complicated, I'll soon create an extra page just for this scenario!

Guide

0. Disable "Propers and Repacks" Upgrade

By default, Radarr and Sonarr prefer Proper / Repack releases and upgrade to such in case they become available at a later stage. This logic neglects any custom format preferences that you will set henceforth, i.e. override language as well as quality preferences. Hence this option has to be disabled. To do so:

  1. Visit Settings > Media Management in both Radarr and Sonarr.
  2. Enable Advanced Settings and scroll to / search for the File Management section.
  3. Set the respective option to Do not prefer and upgrade and hit Save Changes

1. Import the German DL Custom Formats

If you don't know how to import custom formats have a look at this short guide: How to import Custom Formats - Trash Guides

Import the Custom Format "German DL":

{
  "name": "German DL",
  "includeCustomFormatWhenRenaming": true,
  "specifications": [
    {
      "name": "German DL",
      "implementation": "ReleaseTitleSpecification",
      "negate": false,
      "required": true,
      "fields": {
        "value": "(?i)german\\s*\\.?dl|(?<=\\bGerman\\b.*)(?<!\\bWEB[-_. ])\\bDL\\b|\\[DE\\+[a-z]{2}\\]|\\[[a-z]{2}\\+DE\\]|ger,\\s*[a-z]{3}\\]|\\[[a-z]{3}\\s*,\\s*ger\\]"
      }
    }
  ]
}

This custom format matches all possible combinations of "German DL" (without being falsely triggered by WEB-DL). It also matches combinations of [ger,eng] and [DE+EN] which can be found on some torrents.

Import the Custom Format "German DL 2":

 {
  "name": "German DL 2",
  "includeCustomFormatWhenRenaming": false,
  "specifications": [
    {
      "name": "NOT German DL",
      "implementation": "ReleaseTitleSpecification",
      "negate": true,
      "required": true,
      "fields": {
        "value": "(?i)german\\s*\\.?dl|(?<=\\bGerman\\b.*)(?<!\\bWEB[-_. ])\\bDL\\b|\\[DE\\+[a-z]{2}\\]|\\[[a-z]{2}\\+DE\\]|ger,\\s*[a-z]{3}\\]|\\[[a-z]{3}\\s*,\\s*ger\\]"
      }
    },
    {
      "name": "German",
      "implementation": "LanguageSpecification",
      "negate": false,
      "required": true,
      "fields": {
        "value": 4
      }
    },
    {
      "name": "English",
      "implementation": "LanguageSpecification",
      "negate": false,
      "required": true,
      "fields": {
        "value": 1
      }
    }
  ]
}

This custom format is necessary to detect some dual language releases that do not have "German DL" in their name. Note: This custom format has been added at a later stage and is missing from screenshots you will see later.

2. Import the Language: Not ENG/GER Custom Format

Import the Custom Format "Language: Not ENG/GER":

{
  "name": "Language: Not ENG/GER",
  "includeCustomFormatWhenRenaming": false,
  "specifications": [
    {
      "name": "Not English Language",
      "implementation": "LanguageSpecification",
      "negate": true,
      "required": true,
      "fields": {
        "value": 1
      }
    },
    {
      "name": "Not German Language",
      "implementation": "LanguageSpecification",
      "negate": true,
      "required": true,
      "fields": {
        "value": 4
      }
    },
    {
      "name": "Not German in Title",
      "implementation": "ReleaseTitleSpecification",
      "negate": true,
      "required": true,
      "fields": {
        "value": "(?i)\\bgerman\\b"
      }
    }
  ]
}

This custom format is there to exclude any languages other than German and English.

3. Create a Quality Profile

Create a Quality Profile based on the Trash Guides for Radarr and Sonarr. If you're already familiar with setting up quality profiles, you may not need to follow these guides exactly, but they're recommended for those new to the process.

4. Merge Quality

In order to prefer German DL over quality, we need to merge all desired qualities into a single group. merge animation

How to merge qualities - animation from TRaSH Guides (MIT License).

In this example we'll want to prefer the quality in this descending order: Remux-1080p -> Bluray-1080p -> WEBDL-1080 -> Bluray-720p

Here is how it should look after merging the qualities:

Merge Qualities 1 Merge Qualities 2

Despite merging the qualities, it's still possible to upgrade them through custom formats. More details on that can be found in the section Quality Upgrades via Custom Formats.

5. Set the Language

The language in the quality profile profile must be set to Any.

6. Set Upgrade Until Custom

In your quality profile set the value of "Upgrade Until Custom" to 50000

7. Set Custom Format Scores

In the Quality Profile settings, set the scores for the custom formats as follows:

Custom Format Score
German DL 25000
German DL 2 25000
Language: Not ENG/GER -30000

8. Prefer Language

- Prefer German over English if there is no DL Release

This will result in this priority:

  1. German + English language
  2. German language
  3. English language

Import the Custom Format "Language: German Only":

{
  "name": "Language: German Only",
  "includeCustomFormatWhenRenaming": false,
  "specifications": [
    {
      "name": "Language GER",
      "implementation": "LanguageSpecification",
      "negate": false,
      "required": true,
      "fields": {
        "value": 4
      }
    },
    {
      "name": "NOT German DL",
      "implementation": "ReleaseTitleSpecification",
      "negate": true,
      "required": true,
      "fields": {
        "value": "(?i)german\\s*\\.?dl|(?<=\\bGerman\\b.*)(?<!\\bWEB[-_. ])\\bDL\\b|\\[DE\\+[a-z]{2}\\]|\\[[a-z]{2}\\+DE\\]|ger,\\s*[a-z]{3}\\]|\\[[a-z]{3}\\s*,\\s*ger\\]"
      }
    },
    {
      "name": "Not English",
      "implementation": "LanguageSpecification",
      "negate": true,
      "required": true,
      "fields": {
        "value": 1
      }
    }
  ]
}

Set the custom score to 15000.

- Prefer English over German if there is no DL Release

This will result in this priority:

  1. German + English language
  2. English language
  3. German language

Import the Custom Format "Language: English Only":

{
  "name": "Language: English Only",
  "includeCustomFormatWhenRenaming": false,
  "specifications": [
    {
      "name": "Language ENG",
      "implementation": "LanguageSpecification",
      "negate": false,
      "required": true,
      "fields": {
        "value": 1
      }
    },
    {
      "name": "NOT German DL",
      "implementation": "ReleaseTitleSpecification",
      "negate": true,
      "required": true,
      "fields": {
        "value": "(?i)german\\s*\\.?dl|(?<=\\bGerman\\b.*)(?<!\\bWEB[-_. ])\\bDL\\b|\\[DE\\+[a-z]{2}\\]|\\[[a-z]{2}\\+DE\\]|ger,\\s*[a-z]{3}\\]|\\[[a-z]{3}\\s*,\\s*ger\\]"
      }
    },
    {
      "name": "NOT German Language",
      "implementation": "LanguageSpecification",
      "negate": true,
      "required": true,
      "fields": {
        "value": 4
      }
    }
  ]
}

Set the custom score to 15000.

9. Quality Upgrades via Custom Formats

We want to prioritize German DL releases and upgrade to higher qualities within that subset.

Import the Custom Formats you need:

Bluray-1080p (Radarr) ```json { "name": "Bluray-1080p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "Bluray", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 9 } }, { "name": "1080p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 1080 } }, { "name": "Not REMUX", "implementation": "QualityModifierSpecification", "negate": true, "required": true, "fields": { "value": 5 } } ] } ```
Bluray-1080p (Sonarr) ```json { "name": "Bluray-1080p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "Bluray", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 6 } }, { "name": "1080p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 1080 } }, { "name": "Not REMUX", "implementation": "SourceSpecification", "negate": true, "required": true, "fields": { "value": 7 } } ] } ```
Bluray-2160p (Radarr) ```json { "name": "Bluray-2160p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "Bluray", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 9 } }, { "name": "2160p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 2160 } }, { "name": "Not REMUX", "implementation": "QualityModifierSpecification", "negate": true, "required": true, "fields": { "value": 5 } } ] } ```
Bluray-2160p (Sonarr) ```json { "name": "Bluray-2160p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "Bluray", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 6 } }, { "name": "2160p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 2160 } }, { "name": "Not REMUX", "implementation": "SourceSpecification", "negate": true, "required": true, "fields": { "value": 7 } } ] } ```
Bluray-720p (Radarr) ```json { "name": "Bluray-720p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "Bluray", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 9 } }, { "name": "720p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 720 } }, { "name": "Not REMUX", "implementation": "QualityModifierSpecification", "negate": true, "required": true, "fields": { "value": 5 } } ] } ```
Bluray-720p (Sonarr) ```json { "name": "Bluray-720p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "Bluray", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 6 } }, { "name": "720p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 720 } }, { "name": "Not REMUX", "implementation": "SourceSpecification", "negate": true, "required": true, "fields": { "value": 7 } } ] } ```
WEBDL-1080p (Radarr) ```json { "name": "WEBDL-1080p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WEBDL", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 7 } }, { "name": "1080p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 1080 } } ] } ```
WEBDL-1080p (Sonarr) ```json { "name": "WEBDL-1080p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WEBDL", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 3 } }, { "name": "1080p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 1080 } } ] } ```
WEBDL-2160p (Radarr) ```json { "name": "WEBDL-2160p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WEBDL", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 7 } }, { "name": "2160p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 2160 } } ] } ```
WEBDL-2160p (Sonarr) ```json { "name": "WEBDL-2160p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WEBDL", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 3 } }, { "name": "2160p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 2160 } } ] } ```
WEBDL-720p (Radarr) ```json { "name": "WEBDL-720p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WEBDL", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 7 } }, { "name": "720p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 720 } } ] } ```
WEBDL-720p (Sonarr) ```json { "name": "WEBDL-720p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WEBDL", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 3 } }, { "name": "720p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 720 } } ] } ```
WebRip-1080p (Radarr) ```json { "name": "WebRip-1080p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WebRip", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 8 } }, { "name": "1080p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 1080 } } ] } ```
WebRip-1080p (Sonarr) ```json { "name": "WebRip-1080p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WebRip", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 4 } }, { "name": "1080p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 1080 } } ] } ```
WebRip-720p (Radarr) ```json { "name": "WebRip-720p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WebRip", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 8 } }, { "name": "720p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 720 } } ] } ```
WebRip-720p (Sonarr) ```json { "name": "WebRip-720p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "WebRip", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 4 } }, { "name": "720p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 720 } } ] } ```
Remux-1080p (Radarr) ```json { "name": "Remux-1080p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "1080p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 1080 } }, { "name": "REMUX", "implementation": "QualityModifierSpecification", "negate": false, "required": true, "fields": { "value": 5 } } ] } ```
Remux-1080p (Sonarr) ```json { "name": "Remux-1080p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "Remux", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 7 } }, { "name": "1080p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 1080 } }, { "name": "Not BluRay", "implementation": "SourceSpecification", "negate": true, "required": true, "fields": { "value": 6 } } ] } ```
Remux-2160p (Radarr) ```json { "name": "Remux-2160p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "2160p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 2160 } }, { "name": "REMUX", "implementation": "QualityModifierSpecification", "negate": false, "required": true, "fields": { "value": 5 } } ] } ```
Remux-2160p (Sonarr) ```json { "name": "Remux-2160p", "includeCustomFormatWhenRenaming": false, "specifications": [ { "name": "Remux", "implementation": "SourceSpecification", "negate": false, "required": true, "fields": { "value": 7 } }, { "name": "2160p", "implementation": "ResolutionSpecification", "negate": false, "required": true, "fields": { "value": 2160 } }, { "name": "Not BluRay", "implementation": "SourceSpecification", "negate": true, "required": true, "fields": { "value": 6 } } ] } ```

Note: If you require a custom format for a different quality, import one of the above examples and modify the conditions accordingly. It should be relatively straightforward.

In the previous example where we looked for Remux-1080p, Bluray-1080p, WEBDL-1080p, and Bluray-720p, we would need to add a custom format for each of these.

Next, assign scores to these custom formats in the quality profile. Assign 0 for the lowest quality, 2000 for the second lowest, 4000 for the next, and so on, increasing the score by 2000 each time. This scoring system will prioritize and upgrade to higher quality formats when they become available.

Here is an example of what the scoring should look like:

Custom Format Quality

Now, whenever a higher-quality German DL release becomes available, your setup will automatically upgrade to it.

10. Optional: Avoid Mic Dubbed Releases

Mic dubbed (MD) releases are poor quality sound recordings made in movie theaters, for example, and may include sounds made by people there. Very often the first German DL release will have great english soundtrack but a mic dubbed German soundtrack. Unless you are really impatient I highly recommend to avoid them. This is only needed for Radarr, not for Sonarr.

Even if you don't want to avoid them you should still give it a negative score of something like -100 so that Radarr will still upgrade to a non mic dubbed release when possible.

Import the MIC DUB Custom Format:

MIC DUB Custom Format ```json { "name": "MIC DUB", "includeCustomFormatWhenRenaming": true, "specifications": [ { "name": "MD", "implementation": "ReleaseTitleSpecification", "negate": false, "required": true, "fields": { "value": "((19|20|21)[0-9]{2}).*?(?<=^|[ .-])MD(?=[ .-]|$).*?(?<=^|[ .-])GERMAN(?=[ .-]|$)|((19|20|21)[0-9]{2}).*?(?<=^|[ .-])GERMAN(?=[ .-]|$).*?(?<=^|[ .-])MD(?=[ .-]|$)" } } ] } ```

In the Quality Profile settings, set the scores for the custom format as follows:

Custom Format Score
MIC DUB -35000

Contact & Support

Donations

Of course I am always happy about a donation :D PayPal: https://paypal.me/pcjones1

For other donation options please contact me on Discord or Telegram - thanks!

Changelog:

Date Change
2023-08-22 Added BluRay/Remux custom formats for Sonarr because Sonarr doesn't have the Quality Modifier filter
2023-08-27 Added different Web-DL/WebRip custom formats for Sonarr and Radarr as they use different internal ids
2023-09-30 Added "German DL 2" custom format to detect dual language releases which have been identified correctly by Sonarr/Radarr but don't have "German DL" in their name
2024-01-30 Fixed English/German only custom formats being wrongly detected if "German DL 2" custom format was also detected
2024-02-16 Added invite link to the UsenetDE Discord Server