diff --git a/docs/Radarr/Tips/How-to-setup-language-custom-formats.md b/docs/Radarr/Tips/How-to-setup-language-custom-formats.md new file mode 100644 index 000000000..6cbb8a46c --- /dev/null +++ b/docs/Radarr/Tips/How-to-setup-language-custom-formats.md @@ -0,0 +1,190 @@ +# How to setup Language Custom Formats + +Here we will explain how to setup your own preferred language Custom Format, with a few examples. + +!!! warning "Using language Custom Formats is not compatible with setting a preferred language in a quality profile in Radarr. You must use one or the other.
If you want to make use of the Custom Formats set the preferred language to `Any`." + +## Language Examples + +Import the JSON in to your Custom Formats. + +How ? + +Follow the [How to import Custom Formats](/Radarr/Radarr-import-custom-formats/){:target="_blank" rel="noopener noreferrer"}. + +--- + +### Language: Original Only + +Language: Not Original + +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 + [[% filter indent(width=4) %]][[% include 'json/guide-only/language-not-original.json' %]][[% endfilter %]] + ``` + +--- + +### Language: English Only + +Language: Not English + +With this Custom Format you will only get the Movie/TV Show in the English language. + +!!! info "For languages other than English, replace the English condition with language of your choice." + +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 + [[% filter indent(width=4) %]][[% include 'json/guide-only/language-not-english.json' %]][[% endfilter %]] + ``` + +--- + +### Language: Multiple Only + +Language: Not Dutch + +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 only get the Movie/TV Show with Dutch and/or Flemish Audio. + +!!! info "For languages other than Dutch/Flemish, replace the Dutch/Flemish condition with language of your choice." + +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 + [[% filter indent(width=4) %]][[% include 'json/guide-only/language-not-dutch.json' %]][[% endfilter %]] + ``` + +--- + +### Language: Prefer X but i'll take Y + +Language: Not Original or German +Language: Prefer German + +Let's say you want German, but if German is not available then fall back to Original language but don't accept any other translated languages. + +!!! info "For languages other than German, replace the German condition with language of your choice." + +Add the following json to your Radarr/Sonarr with a score of `-10000`. + +??? example "JSON - [CLICK TO EXPAND]" + + ```json + [[% filter indent(width=4) %]][[% include 'json/guide-only/language-not-original-or-german.json' %]][[% endfilter %]] + ``` + +Add the following json to your Radarr/Sonarr with a score of `10`. + +??? example "JSON - [CLICK TO EXPAND]" + + ```json + [[% filter indent(width=4) %]][[% include 'json/guide-only/language-prefer-german.json' %]][[% endfilter %]] + ``` + +--- + +### Language: Prefer Language X + +Language: Prefer German + +Let's say you just want to prefer German and don't care if you get another random language(s). + +!!! info "For languages other than German, replace the German condition with language of your choice." + +Add the following json to your Radarr/Sonarr with a score of `10`. + +??? example "JSON - [CLICK TO EXPAND]" + + ```json + [[% filter indent(width=4) %]][[% include 'json/guide-only/language-prefer-german.json' %]][[% endfilter %]] + ``` + +--- + +### Language: Prefer Multi Language + +Language: Prefer Dutch + +In some case you may want prefer multiple languages in your Custom Format. + +With this Custom Format you will only get the Movie/TV Show with either Preferred Language. + +In this example I will use Dutch and Flemish since a lot of Movies/TV Shows since there is a lot of collaboration between the two countries/studio's. + +!!! info "For languages other than Dutch/Flemish, replace the Dutch/Flemish condition with language of your choice." + +Add the following json to your Radarr/Sonarr with a score of `10`. + +??? example "JSON - [CLICK TO EXPAND]" + + ```json + [[% filter indent(width=4) %]][[% include 'json/guide-only/language-prefer-dutch.json' %]][[% endfilter %]] + ``` + +--- + +## FAQ & INFO + +### What's reverse scoring + +??? FAQ "What's reverse scoring? - [CLICK TO EXPAND]" + + With reverse scoring you add a Custom Format with a score of `-10000` and your preferred condition you negate. + + So in the case of the following Custom Format `Language: Original Only`, it will actually match all Not Original releases and give it a score of `-10000`. + +### Prefer language X over language Y + +??? FAQ "Prefer language X over language Y - [CLICK TO EXPAND]" + + If you want to prefer Prefer language X over language Y, + + you add for example: `Language: Prefer Language X` with a score of `10`, and add `Language: Prefer Language Y` with score of `9`. + + Which scores you should use depends on how important the language is compared to other Custom Formats you're using. + +### What's Original Language + +??? FAQ "What's Original Language? - [CLICK TO EXPAND]" + + Original Language is the language in which a Movie/TV Show was originally made. + +### Where does Radarr get the Original Language from + +??? FAQ "Where does Radarr get the Original Language from? - [CLICK TO EXPAND]" + + Radarr makes use of [The Movie Database (TMDB)](https://www.themoviedb.org/){:target="_blank" rel="noopener noreferrer"}. + + ![!The Movie Database (TMDB) Original Language](images/original-language-tmdb.png) + +### Where does Sonarr get the Original Language from + +??? FAQ "Where does Sonarr get the Original Language from? - [CLICK TO EXPAND]" + + Sonarr makes use of [TheTVDB](https://thetvdb.com/){:target="_blank" rel="noopener noreferrer"}. + + ![!TheTVDB Original Language](images/original-language-tvdb.png) + +--8<-- "includes/support.md" diff --git a/docs/Radarr/Tips/images/original-language-tmdb.png b/docs/Radarr/Tips/images/original-language-tmdb.png new file mode 100644 index 000000000..7ddece6f7 Binary files /dev/null and b/docs/Radarr/Tips/images/original-language-tmdb.png differ diff --git a/docs/Radarr/Tips/images/original-language-tvdb.png b/docs/Radarr/Tips/images/original-language-tvdb.png new file mode 100644 index 000000000..ee3cdcd26 Binary files /dev/null and b/docs/Radarr/Tips/images/original-language-tvdb.png differ diff --git a/docs/Sonarr/Tips/How-to-setup-language-custom-formats.md b/docs/Sonarr/Tips/How-to-setup-language-custom-formats.md new file mode 100644 index 000000000..bd9cdb28b --- /dev/null +++ b/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 +!} diff --git a/docs/json/guide-only/language-not-dutch.json b/docs/json/guide-only/language-not-dutch.json new file mode 100644 index 000000000..9011be8f9 --- /dev/null +++ b/docs/json/guide-only/language-not-dutch.json @@ -0,0 +1,27 @@ +{ + "trash_id": "guide-only", + "trash_score": "-10000", + "trash_description": "Language: Multiple Only", + "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 + } + } + ] +} diff --git a/docs/json/guide-only/language-not-english.json b/docs/json/guide-only/language-not-english.json new file mode 100644 index 000000000..0ad091dbc --- /dev/null +++ b/docs/json/guide-only/language-not-english.json @@ -0,0 +1,18 @@ +{ + "trash_id": "guide-only", + "trash_score": "-10000", + "trash_description": "Language: English Only", + "name": "Language: Not English", + "includeCustomFormatWhenRenaming": false, + "specifications": [ + { + "name": "Not English Language", + "implementation": "LanguageSpecification", + "negate": true, + "required": false, + "fields": { + "value": 1 + } + } + ] +} diff --git a/docs/json/guide-only/language-not-original-or-german.json b/docs/json/guide-only/language-not-original-or-german.json new file mode 100644 index 000000000..5af82821b --- /dev/null +++ b/docs/json/guide-only/language-not-original-or-german.json @@ -0,0 +1,27 @@ +{ + "trash_id": "guide-only", + "trash_score": "-10000", + "trash_description": "Language: Prefer X but i'll take Y", + "name": "Language: Not Original or German", + "includeCustomFormatWhenRenaming": false, + "specifications": [ + { + "name": "Not Original", + "implementation": "LanguageSpecification", + "negate": true, + "required": true, + "fields": { + "value": -2 + } + }, + { + "name": "Not German", + "implementation": "LanguageSpecification", + "negate": true, + "required": true, + "fields": { + "value": 4 + } + } + ] +} diff --git a/docs/json/guide-only/language-not-original.json b/docs/json/guide-only/language-not-original.json new file mode 100644 index 000000000..cf8cfe3f6 --- /dev/null +++ b/docs/json/guide-only/language-not-original.json @@ -0,0 +1,18 @@ +{ + "trash_id": "guide-only", + "trash_score": "-10000", + "trash_description": "Language: Original Only", + "name": "Language: Not Original", + "includeCustomFormatWhenRenaming": false, + "specifications": [ + { + "name": "Not Original Language", + "implementation": "LanguageSpecification", + "negate": true, + "required": false, + "fields": { + "value": -2 + } + } + ] +} diff --git a/docs/json/guide-only/language-prefer-dutch.json b/docs/json/guide-only/language-prefer-dutch.json new file mode 100644 index 000000000..e0411a98c --- /dev/null +++ b/docs/json/guide-only/language-prefer-dutch.json @@ -0,0 +1,27 @@ +{ + "trash_id": "guide-only", + "trash_score": "10", + "trash_description": "Prefer Multiple", + "name": "Language: Prefer Dutch", + "includeCustomFormatWhenRenaming": false, + "specifications": [ + { + "name": "Dutch Language", + "implementation": "LanguageSpecification", + "negate": false, + "required": false, + "fields": { + "value": 7 + } + }, + { + "name": "Flemish Language", + "implementation": "LanguageSpecification", + "negate": false, + "required": false, + "fields": { + "value": 19 + } + } + ] +} diff --git a/docs/json/guide-only/language-prefer-german.json b/docs/json/guide-only/language-prefer-german.json new file mode 100644 index 000000000..a74353c2b --- /dev/null +++ b/docs/json/guide-only/language-prefer-german.json @@ -0,0 +1,18 @@ +{ + "trash_id": "guide-only", + "trash_score": "10", + "trash_description": "Prefer Language X", + "name": "Language: Prefer German", + "includeCustomFormatWhenRenaming": false, + "specifications": [ + { + "name": "German Language", + "implementation": "LanguageSpecification", + "negate": false, + "required": false, + "fields": { + "value": 4 + } + } + ] +} diff --git a/docs/json/sonarr/cf/remux-tier-02.json b/docs/json/sonarr/cf/remux-tier-02.json index f04cd33b0..3b9e2d017 100644 --- a/docs/json/sonarr/cf/remux-tier-02.json +++ b/docs/json/sonarr/cf/remux-tier-02.json @@ -49,6 +49,15 @@ "value": "\\b(KRaLiMaRKo)\\b" } }, + { + "name": "playBD", + "implementation": "ReleaseGroupSpecification", + "negate": false, + "required": false, + "fields": { + "value": "\\b(playBD)\\b" + } + }, { "name": "PTer", "implementation": "ReleaseGroupSpecification",