[Starr] How to setup Language Custom Formats

docs/Radarr/Tips/How-to-setup-language-custom-formats.md

@@ -0,0 +1,213 @@
+# How to setup Language Custom Formats
+
+Here we will try to explain how to setup your own preferred language Custom Format, with a few examples.
+
+## Language Examples
+
+### Language: Original Only
+
+<sub><sub>Language: Not Original</sub>
+
+This is one of the most common one used besides the English only one.
+
+With this Custom Format you will get only the Movie/TV Show with the original language.
+
+For this we're going to make use of so called reverse scoring.
+
+Add the following json to your Radarr/Sonarr with a score of `-10000`.
+
+??? example "JSON - [CLICK TO EXPAND]"
+
+    ```json
+    {
+      "trash_score": "-10000",
+      "name": "Language: Not Original",
+      "includeCustomFormatWhenRenaming": false,
+      "specifications": [
+        {
+          "name": "Not Original Language",
+          "implementation": "LanguageSpecification",
+          "negate": true,
+          "required": true,
+          "fields": {
+            "value": -2
+          }
+        }
+      ]
+    }
+    ```
+
+### Language: English Only
+
+<sub><sub>Language: Not English</sub>
+
+With this Custom Format you will get only the Movie/TV Show in the English language.
+
+!!! info "Replace the English condition with your preferred language."
+
+For this we're going to make use of so called reverse scoring.
+
+Add the following json to your Radarr/Sonarr with a score of `-10000`.
+
+??? example "JSON - [CLICK TO EXPAND]"
+
+    ```json
+    {
+      "trash_score": "-10000",
+      "trash_description": "Language: English Only",
+      "name": "Language: Not English",
+      "includeCustomFormatWhenRenaming": false,
+      "specifications": [
+        {
+          "name": "Not English Language",
+          "implementation": "LanguageSpecification",
+          "negate": true,
+          "required": true,
+          "fields": {
+            "value": 1
+          }
+        }
+      ]
+    }
+    ```
+
+### Language: Multiple Only
+
+<sub><sub>Language: Not Dutch</sub>
+
+In some case you need multiple languages in your Custom Format for different reasons,
+
+in this example I will use Dutch and Flemish being a lot of Movies/TV Shows are collaborate made between the 2 countries/studio's.
+
+With this Custom Format you will get only the Movie/TV Show with Dutch and/or Flemish Audio.
+
+!!! info "Replace the Dutch/Flemish conditions with your preferred language(s)."
+
+For this we're going to make use of so called reverse scoring.
+
+Add the following json to your Radarr/Sonarr with a score of `-10000`.
+
+??? example "JSON - [CLICK TO EXPAND]"
+
+    ```json
+    {
+      "trash_score": "-10000",
+      "name": "Language: Not Dutch",
+      "includeCustomFormatWhenRenaming": false,
+      "specifications": [
+        {
+          "name": "Not Dutch Language",
+          "implementation": "LanguageSpecification",
+          "negate": true,
+          "required": true,
+          "fields": {
+            "value": 7
+          }
+        },
+        {
+          "name": "Not Flemish Language",
+          "implementation": "LanguageSpecification",
+          "negate": true,
+          "required": true,
+          "fields": {
+            "value": 19
+          }
+        }
+      ]
+    }
+    ```
+
+### Language: Prefer X but i'll take Y
+
+<sub><sub>Language: Not German or Original</sub>
+<sub><sub>Language: Prefer German</sub>
+
+Let's say you want German, but you take the Original language if no German is available, but don't want any other translated languages.
+
+!!! info "Replace the German conditions with your preferred language(s)."
+
+Add the following json to your Radarr/Sonarr with a score of `-10000`.
+
+??? example "JSON - [CLICK TO EXPAND]"
+
+      ```json
+      {
+        "trash_score": "-10000",
+        "name": "Language: Not German or Original",
+        "includeCustomFormatWhenRenaming": false,
+        "specifications": [
+          {
+            "name": "Not German",
+            "implementation": "LanguageSpecification",
+            "negate": true,
+            "required": true,
+            "fields": {
+              "value": 4
+            }
+          },
+          {
+            "name": "Not Original",
+            "implementation": "LanguageSpecification",
+            "negate": true,
+            "required": true,
+            "fields": {
+              "value": -2
+            }
+          }
+        ]
+      }
+      ```
+
+Add the following json to your Radarr/Sonarr with a score of `10`.
+
+??? example "JSON - [CLICK TO EXPAND]"
+
+    ```json
+    {
+      "trash_score": "10",
+      "name": "Language: Prefer German",
+      "includeCustomFormatWhenRenaming": false,
+      "specifications": [
+        {
+          "name": "German Language",
+          "implementation": "LanguageSpecification",
+          "negate": false,
+          "required": true,
+          "fields": {
+            "value": 4
+          }
+        }
+      ]
+    }
+    ```
+
+### Language: Prefer Language X
+
+<sub><sub>Language: Prefer German</sub>
+
+Let's say you just want to prefer German and don't care if you get another random language(s).
+
+!!! info "Replace the German conditions with your preferred language(s)."
+
+Add the following json to your Radarr/Sonarr with a score of `10`.
+
+??? example "JSON - [CLICK TO EXPAND]"
+
+    ```json
+    {
+      "trash_score": "10",
+      "name": "Language: Prefer German",
+      "includeCustomFormatWhenRenaming": false,
+      "specifications": [
+        {
+          "name": "German Language",
+          "implementation": "LanguageSpecification",
+          "negate": false,
+          "required": true,
+          "fields": {
+            "value": 4
+          }
+        }
+      ]
+    }
+    ```

docs/Sonarr/Tips/How-to-setup-language-custom-formats.md

@@ -0,0 +1,4 @@
+{!
+    include-markdown '../../Radarr/Tips/How-to-setup-language-custom-formats.md'
+    rewrite_relative_urls=true
+!}