feat(radarr): NEW German guide (#1993)

* First draft of german guide

* Fix scores for german CFs

* Added german CFs to collection of custom formats

* Fix anchor links for german audio versions

* Added description of the german audio language CFs

* Fixed build errors

* Fixed some more build errors

* Removed some mentions to French audio

* Added quality merging

* Changed x265 score to 0 and added disclaimer about good groups producing x265 encodes

* Added resolution scoring and changed some wording

* Removed some mention to the French Guide

* Added source CFs, updated qp image, wording and formatting improvements

* Fixed build errors

* Added maintainer and acknowledgments

* Merged Scene Tiers, added some Groups to P2P Tiers

* Added muhHD to german scene, added note about releases being identified as german.dl for releases where german is the original language

* Always capitalize German

* Clarify german DL CF descriptions

* Use "Will rename the release" for consistency

* Clarify wording

* Clarify german scene CF

* Rename German Micro>German Microsized

* Clarify German LQ other reasons

* Add w00t to german microsized

* Fix release group regexes

* Move PXL to tier 01

* Update german guide

* Fix german microsized json

* Fix german microsized json

* Update german guide

* Intermediate commit

* Intermediate commit

* Fix no final newline

* Fix double blank lines

* Add GTF to German microsized groups

* Update trash id

* Removed duplicate Attention block

* Added LD/MD to Unwanted section

* Fix: linter errors and add new CFs

* Fix: CF Issue

* Fix: Build errors with file no longer existing

* Fix: markdown issues

* Fix: Updated formatting and added remaining Quality Profile descriptions

* Fix: fixed some typos

* Fix: too many spaces

* Fix: adjusted german LQ and german micro scores to be sure we get negative scores

* Fix: removed groups from tiers based on sources they release

* Fix: removed some more groups from tiers based on sources they release

* Fix: removed outdated cfs

* Fix: updated acknowledgments

* Fix: improved wording

* Fix: markdown error

* Fix: more new-lines for better readability

* Fix: spelling

* Fix: mention umlautadaptarr to help with umlauts and german titles

* Fix: added reference to german guide on index page

* Fix: markdown error

* Fix: removed unneeded source CFs

* Fix: provided example for German.DL fallback

* Added 4SF to Web Tier 02

* Added CNY and ABJ

* Fixed Tylor.D Regex

* Fix: renamed german.dl-fallback to german.dl-undefined for consistency

* Fix: grammar and spelling

* Added CNY to Bluray Tier 01

* Added disclaimer about german audio quality and some grammar improvements

* Fix: removed unneeded original language CF, changed solution for users which only want german media

* Fix: formatting

* Added Acknowledgement for Someone said Nice

* Added note for Web fallback for Remux 2160p

* Markdown fixes

* Used Grammarly to grammar check the page

* Fixed: table formatting and some Grammararly checks

* Added: on request a dot between `German` and `DL`

* Added: missing CF and fixed a few other stuff

* Added: The German custom formats were added, and the layout was reorganized.

* Added: The needed German score

* Fixed: last minute CF name change for German DL

* several other fixes to complete the build without errors

* fixed: ident

* fix: json errors

* fix: testing if the json validation knows about `('exceptLanguage', 'value' were unexpected)`

* fix: remove the exceptLanguage from the json

* fixed: some minor styling/grammar stuff

* Added: German CF to the table and updated descriptions

* fix: formatting

---------

Co-authored-by: Lokilicious <mail.lokilicious.work>
Co-authored-by: Jonas F <[email protected]>
Co-authored-by: pcjones <[email protected]>
Co-authored-by: TRaSH <[email protected]>
Co-authored-by: TRaSH <[email protected]>

docs/Radarr/.pages

@@ -5,6 +5,7 @@ nav:
   - How to set up Quality Profiles: radarr-setup-quality-profiles.md
   - How to set up Quality Profiles (Anime): radarr-setup-quality-profiles-anime.md
   - How to set up Quality Profiles (French): radarr-setup-quality-profiles-french-en.md
+  - How to set up Quality Profiles (German): radarr-setup-quality-profiles-german-en.md
   - How to import Custom Formats: Radarr-import-custom-formats.md
   - How to Update Custom Formats: Radarr-how-to-update-custom-formats.md
   - Collection of Custom Formats: Radarr-collection-of-custom-formats.md

docs/Radarr/index.md

@@ -17,6 +17,7 @@ After setting up your optimal volume/paths found [HERE](/File-and-Folder-Structu
 1. [How to set up Quality Profiles](/Radarr/radarr-setup-quality-profiles/) - How to make the most use of the Custom Formats and shows some specifics of our recommended configuration. You can use these examples to understand how to set up your preferences.
     - [How to setup Quality Profiles Anime](/Radarr/radarr-setup-quality-profiles-anime/) - Same as above but specific for anime.
     - [How to set up Quality Profiles (French)](/Radarr/radarr-setup-quality-profiles-french-en/) - Same as above but specific for French and English Audio.
+    - [How to set up Quality Profiles (German)](/Radarr/radarr-setup-quality-profiles-german-en/) - Same as above but specific for German and English Audio.
 
 ---
 

docs/Radarr/radarr-setup-quality-profiles-german-en.md

@@ -0,0 +1,247 @@
+# How to setup Quality Profiles (German)
+
+*aka How to setup Custom Formats to get German Audio if available*<br><br>
+
+!!! note "This guide is created and maintained by [Lokilicious](https://github.com/Lokilicious) and [PCJones](https://github.com/PCJones)"
+
+There isn't a *best* way to set up Custom Formats to get German (or German+English dual) audio. It depends on your setup (hardware devices) and personal preferences.
+
+Some prefer high-quality audio (HD Audio), and others prefer high-quality video. Many prefer both.
+
+In this Guide, we try to give a recommendation that suits most users.
+
+---
+
+## Basics
+
+It is quite important that you follow and understand what is expected by TRaSH's guide:
+
+- Adding Custom Formats, as explained in [How to import Custom Formats](/Radarr/Radarr-import-custom-formats/){:target="_blank" rel="noopener noreferrer"}.
+- Setting up a quality Profile to make use of the Custom Formats, as explained in [How to setup Quality Profiles | Basics section](/Radarr/radarr-setup-quality-profiles/#basics){:target="_blank" rel="noopener noreferrer"}.
+
+!!! warning "Please read those two sections before continuing the guide, as they contain important information. The rest of this guide will assume you did."
+
+!!! tip
+    TRaSH created a [flowchart](/Radarr/Radarr-setup-custom-formats/#which-quality-profile-should-you-choose){:target="\_blank" rel="noopener noreferrer"} to make your decision easier. Remember that this chart does not include any of the following Custom Formats, and you will still need to read this guide to get German-only/German Dual Language("German DL") releases.
+
+---
+
+## Using this Guide
+
+There are two ways of using this Guide, with and without TRaSH original Guide's international/English-based group tiers.
+(which can be found here: [Collection of Custom Formats](/Radarr/Radarr-collection-of-custom-formats/){:target="_blank" rel="noopener noreferrer"}).
+
+In this Guide, we focus on combining both languages and thus include the Custom Formats from TRaSH's original Guide.
+
+These Custom Formats are recommended if you prefer German Dual-Language releases but also want to download the original and/or English audio if no German Dual-Language is available (yet). This ensures the original English release will be of the best quality possible.
+
+---
+
+## Radarr specific settings
+
+There are a couple of changes that are needed for German Custom Formats to work properly:
+
+??? abstract "Set the language to `Any` in the quality profile - [Click to show/hide]"
+    We choose `Any` for the language profile, as otherwise, English movies identified with German audio and vice-versa will not be grabbed.
+
+    ??? success "Screenshot example - [Click to show/hide]"
+        ![!cf-quality-profile-cf](images/german-cf-profile-language.png)
+
+??? abstract "Disable Propers and Repacks - [Click to show/hide]"
+    Change the Propers and Repacks setting in `Media Management` => `File Management` to `Do Not Prefer` and use the [Repack/Proper](/Radarr/Radarr-collection-of-custom-formats/#repackproper) Custom Formats.
+
+    This way, you can ensure that Custom Formats preferences are used and not ignored.
+
+    You can still prefer Propers and Repacks through the provided Custom Formats.
+
+    ??? success "Screenshot example - [Click to show/hide]"
+        ![!cf-mm-propers-repacks-disable](/Radarr/images/cf-mm-propers-repacks-disable.png)
+
+??? abstract "Merge Qualities - [Click to show/hide]"
+
+    To allow upgrades based on language without release qualities interfering, we need to [merge all desired qualities](/Radarr/Tips/Merge-quality/) into one group.
+
+    We want to merge the following Qualities:
+
+    - Remux-2160p
+    - Bluray-2160p
+    - WEBDL-2160p
+    - WEBRip-2160p
+    - Remux-1080p
+    - Bluray-1080p
+    - WEBDL-1080p
+    - WEBRip-1080p
+    - Bluray-720p
+    - WEBDL-720p
+    - WEBRip-720p
+
+    and name it: `Bluray|WEB`
+
+    !!! warning "Make sure you do not check BR-DISK."
+
+    {! include-markdown "../../includes/starr/move-quality-to-top.md" !}
+
+    !!! tip "Tip"
+        You don't need to include some of these resolutions, such as 2160p or 720p, if you are not interested in them.
+
+??? abstract "Adapt the Standard Movie Format and Movie Folder Format - [Click to show/hide]"
+    Please have a look here: [Recommended naming scheme](/Radarr/Radarr-recommended-naming-scheme/){:target="_blank" rel="noopener noreferrer"}.
+
+    !!! tip "Movie format/folder with the German movie name."
+        Radarr supports the ISO-2 naming convention for naming movies, so replacing `{Movie CleanTitle}` with `{Movie CleanTitle:de}` will change the name to its German version.
+
+??? abstract "Change the Indexers Multi Languages option - [Click to show/hide]"
+    In Radarr, you can tell that MULTi in an indexer means that a release possesses at least certain audio. You should select `Original` and `German` for this guide.
+    This option should only be used for German indexers. Doing so on "international" indexers can create false positives with the German Audio CFs.
+
+    If you do not see the option, you need to activate Radarr's "Advanced Options."
+
+    ??? success "Screenshot example - [Click to show/hide]"
+        ![French Radarr MULTi settings](images/german-starr-multi-settings.png)
+
+---
+
+## Dealing with German Umlauts and German titles
+
+Two facts can lead to Radarr being unable to match a German movie release.
+
+- Indexers typically do not allow the use of German Umlauts in release names.
+- Most movies have titles that are different in German from those in English.
+
+To help with this, there is a handy service called [Umlautadaptarr](https://github.com/PCJones/UmlautAdaptarr). This service acts as a middle layer between Radarr and the Indexer to ensure that Umlauts and German titles are mapped correctly.
+
+---
+
+## Score logic
+
+--8<-- "includes/cf/score-attention.md"
+
+---
+
+## Quality profiles
+
+### German audio
+
+Depending on what's released first and available, the following Workflow Logic will be used:
+
+- When an `English` version is released, it will download the release in the best available quality based on the Custom Formats used.
+- When a `German` or `German DL` version is released, it will upgrade to that version.
+- The downloaded media will be upgraded to any of the added Custom Formats until the defined Score defined in the Quality Profile under `Upgrade Until Custom Format Score` is reached.
+
+!!! tip "Download German audio ^^only^^"
+
+    Set the `Minimum Custom Format Score` in your Quality Profile to `10k`
+    Note: Most German releases come in dual languages, so you might still see an English audio track in addition to the German one.
+
+!!! warning "Releases where German is the original language"
+
+    Due to technical limitations, releases in which German is the movie's original language will be identified as `German DL` even though they might not contain another language.
+    The only (cosmetic) impact of this is that the scores of those releases will be slightly higher than expected.
+
+{! include-markdown "../../includes/german-guide/radarr-german-advanced-audio-information-en.md" !}
+
+---
+
+### Releases you should avoid
+
+This is a must-have for every Quality Profile you use. All these Custom Formats make sure you don't get Low Quality Releases.
+
+{! include-markdown "../../includes/german-guide/radarr-german-unwanted-en.md" !}
+
+---
+
+### HD Bluray + WEB (1080p)
+
+{! include-markdown "../../includes/german-guide/radarr-german-audio-version-en.md" !}
+
+{! include-markdown "../../includes/german-guide/radarr-cf-german-hd-bluray-web-scoring-en.md" !}
+
+{! include-markdown "../../includes/cf/radarr-misc-required.md" !}
+
+{! include-markdown "../../includes/german-guide/radarr-cf-german-resolution-scoring-en.md" !}
+
+{! include-markdown "../../includes/german-guide/radarr-german-unwanted-en.md" !}
+
+{! include-markdown "../../includes/cf/radarr-streaming-services.md" !}
+
+**The following Custom Formats are optional:**
+
+{! include-markdown "../../includes/cf/radarr-misc-optional.md" !}
+
+{! include-markdown "../../includes/cf/radarr-movie-versions-imaxe-noremux.md" !}
+
+---
+
+### UHD Bluray + WEB (2160p)
+
+{! include-markdown "../../includes/german-guide/radarr-german-audio-version-en.md" !}
+
+{! include-markdown "../../includes/german-guide/radarr-cf-german-uhd-bluray-web-scoring-en.md" !}
+
+{! include-markdown "../../includes/cf/radarr-all-hdr-formats.md" !}
+
+{! include-markdown "../../includes/cf/radarr-misc-required.md" !}
+
+{! include-markdown "../../includes/german-guide/radarr-cf-german-resolution-scoring-en.md" !}
+
+{! include-markdown "../../includes/german-guide/radarr-german-unwanted-en.md" !}
+
+{! include-markdown "../../includes/cf/radarr-streaming-services.md" !}
+
+**The following Custom Formats are optional:**
+
+{! include-markdown "../../includes/cf/radarr-audio.md" !}
+
+{! include-markdown "../../includes/cf/radarr-misc-optional.md" !}
+
+{! include-markdown "../../includes/cf/radarr-misc-uhd-optional.md" !}
+
+{! include-markdown "../../includes/cf/radarr-movie-versions-imaxe-noremux.md" !}
+
+---
+
+### UHD Remux + WEB (2160p)
+
+{! include-markdown "../../includes/german-guide/radarr-german-audio-version-en.md" !}
+
+{! include-markdown "../../includes/german-guide/radarr-cf-german-remux-web-scoring-en.md" !}
+
+{! include-markdown "../../includes/cf/radarr-all-hdr-formats.md" !}
+
+{! include-markdown "../../includes/cf/radarr-misc-required.md" !}
+
+{! include-markdown "../../includes/german-guide/radarr-cf-german-resolution-scoring-en.md" !}
+
+{! include-markdown "../../includes/german-guide/radarr-german-unwanted-en.md" !}
+
+{! include-markdown "../../includes/cf/radarr-streaming-services.md" !}
+
+**The following Custom Formats are optional:**
+
+{! include-markdown "../../includes/cf/radarr-audio.md" !}
+
+{! include-markdown "../../includes/cf/radarr-misc-optional.md" !}
+
+{! include-markdown "../../includes/cf/radarr-misc-uhd-optional.md" !}
+
+{! include-markdown "../../includes/cf/radarr-movie-versions-imaxe.md" !}
+
+---
+
+### Advanced Audio and HDR Formats
+
+TRaSH provides great guides and explanations about them at the following links:
+
+- [Advanced Audio](/Radarr/radarr-setup-quality-profiles/#advanced-audio){:target="_blank" rel="noopener noreferrer"}
+- [HDR Formats](/Radarr/radarr-setup-quality-profiles/#hdr-formats){:target="_blank" rel="noopener noreferrer"}
+
+---
+
+## Acknowledgements
+
+- A special thanks to the awesome community at the [UsenetDE Discord](https://discord.gg/NBrHshesU9) for their contribution during the guide creation.
+- [TRaSH](https://trash-guides.info/), for granting us a small space on his guide for this, his knowledge, and his friendliness.
+- [Someone Said "Nice"?](https://github.com/NiceTSY), for laying the foundation for the German guide through his work on the French guide.
+- and to all the people who helped us to test those profiles and formats (and continue to do so).
+
+--8<-- "includes/support.md"

docs/json/radarr/cf/german-1080p-booster.json

@@ -0,0 +1,37 @@
+{
+  "trash_id": "3bc8df3a71baaac60a31ef696ea72d36",
+  "trash_scores": {
+      "default": 250
+  },
+  "name": "German 1080p Booster",
+  "includeCustomFormatWhenRenaming": false,
+  "specifications": [
+    {
+      "name": "German",
+      "implementation": "LanguageSpecification",
+      "negate": false,
+      "required": true,
+      "fields": {
+        "value": 4
+      }
+    },
+    {
+      "name": "Original Language",
+      "implementation": "LanguageSpecification",
+      "negate": false,
+      "required": true,
+      "fields": {
+        "value": -2
+      }
+    },
+    {
+      "name": "1080p",
+      "implementation": "ResolutionSpecification",
+      "negate": false,
+      "required": true,
+      "fields": {
+        "value": 1080
+      }
+    }
+  ]
+}

docs/json/radarr/cf/german-2160p-booster.json

@@ -0,0 +1,37 @@
+{
+  "trash_id": "cc7b1e64e2513a6a271090cdfafaeb55",
+  "trash_scores": {
+      "default": 6750
+  },
+  "name": "German 2160p Booster",
+  "includeCustomFormatWhenRenaming": false,
+  "specifications": [
+    {
+      "name": "German",
+      "implementation": "LanguageSpecification",
+      "negate": false,
+      "required": true,
+      "fields": {
+        "value": 4
+      }
+    },
+    {
+      "name": "Original Language",
+      "implementation": "LanguageSpecification",
+      "negate": false,
+      "required": true,
+      "fields": {
+        "value": -2
+      }
+    },
+    {
+      "name": "2160p",
+      "implementation": "ResolutionSpecification",
+      "negate": false,
+      "required": true,
+      "fields": {
+        "value": 2160
+      }
+    }
+  ]
+}