feat(guides): Improve description for x265 (no HDR/DV), x265 (HD)…

… and `SDR (no WEBDL)` (#1941) * feat(guides: Improve description for `x265 (no HDR/DV)`, `x265 (HD)` and `SDR (no WEBDL)` * Fixed: Styling * Replaced: Dedicated ones for Radarr/Sonarr * Removed: because it's identical with the guide one * Fix: MD036 * Apply suggestions from code review Co-authored-by: zakary <[email protected]> --------- Co-authored-by: zakary <[email protected]>
TRaSH-Guides · May 22, 2024 · 0f747c3 · 0f747c3
1 parent a73a584
commit 0f747c3
Show file tree

Hide file tree

Showing 30 changed files with 105 additions and 132 deletions.
diff --git a/docs/Radarr/Radarr-collection-of-custom-formats.md b/docs/Radarr/Radarr-collection-of-custom-formats.md
@@ -984,15 +984,7 @@ We've made 3 guides related to this.
 
 ??? question "x265 (HD) - [Click to show/hide]"
 
-    This blocks all 720/1080p (HD) releases that are encoded in x265.
-
-    In your quality profile use the following score for this Custom Format: `{{ radarr['cf']['x265-hd']['trash_scores']['default'] }}`
-
-    !!! failure ""
-
-        --8<-- "includes/docker/x265.md"
-
-            !!! Danger "Don't use this together with [{{ radarr['cf']['x265-no-hdrdv']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#x265-no-hdrdv), Only ever include one of them :warning:"
+    {! include-markdown "../../includes/cf-descriptions/x265-hd-radarr.md" !}
 
 ??? example "JSON - [Click to show/hide]"
 
@@ -1206,15 +1198,7 @@ We've made 3 guides related to this.
 
 ??? question "x265 (no HDR/DV) - [Click to show/hide]"
 
-    This blocks most 720/1080p (HD) releases that are encoded in x265.
-
-    **But it will allow 720/1080p x265 releases if they have HDR and/or DV**
-
-    *Being that some NF releases won't be released as 4k, but you want to have DV/HDR releases.*
-
-    In your quality profile use the following score for this Custom Format: `{{ radarr['cf']['x265-no-hdrdv']['trash_scores']['default'] }}`
-
-    !!! Danger "Don't use this together with [{{ radarr['cf']['x265-hd']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#x265-hd), Only ever include one of them :warning:"
+    {! include-markdown "../../includes/cf-descriptions/x265-no-hdrdv-radarr.md" !}
 
 ??? example "JSON - [Click to show/hide]"
 
@@ -1301,7 +1285,7 @@ We've made 3 guides related to this.
 
 ??? question "SDR (no WEBDL) - [Click to show/hide]"
 
-    {! include-markdown "../../includes/cf-descriptions/sdr-no-webdl.md" !}
+    {! include-markdown "../../includes/cf-descriptions/sdr-no-webdl-radarr.md" !}
 
 ??? example "JSON - [Click to show/hide]"
 

diff --git a/docs/Sonarr/sonarr-collection-of-custom-formats.md b/docs/Sonarr/sonarr-collection-of-custom-formats.md
@@ -813,15 +813,7 @@ We've made 3 guides related to this.
 
 ??? question "x265 (HD) - [Click to show/hide]"
 
-    This blocks/ignores 720/1080p(HD) releases that are encoded in x265
-
-    In your quality profile use the following score for this Custom Format: `{{ sonarr['cf']['x265-hd']['trash_scores']['default'] }}`
-
-    !!! failure ""
-
-        --8<-- "includes/docker/x265.md"
-
-            !!! Danger "Don't use this together with [{{ sonarr['cf']['x265-no-hdrdv']['name'] }}](/Sonarr/sonarr-collection-of-custom-formats/#x265-no-hdrdv), Only ever include one of them :warning:"
+    {! include-markdown "../../includes/cf-descriptions/x265-hd-sonarr.md" !}
 
 ??? example "JSON - [Click to show/hide]"
 
@@ -1212,15 +1204,7 @@ We've made 3 guides related to this.
 
 ??? question "x265 (no HDR/DV) - [Click to show/hide]"
 
-    This blocks most 720/1080p (HD) releases that are encoded in x265.
-
-    **But it will allow 720/1080p x265 releases if they have HDR and/or DV**
-
-    *Being that some NF releases won't be released as 4k, but you want to have DV/HDR releases.*
-
-    In your quality profile use the following score for this Custom Format: `{{ sonarr['cf']['x265-no-hdrdv']['trash_scores']['default'] }}`
-
-    !!! Danger "Don't use this together with [{{ sonarr['cf']['x265-hd']['name'] }}](/Sonarr/sonarr-collection-of-custom-formats/#x265-hd), Only ever include one of them :warning:"
+    {! include-markdown "../../includes/cf-descriptions/x265-no-hdrdv-sonarr.md" !}
 
 ??? example "JSON - [Click to show/hide]"
 
@@ -1307,7 +1291,7 @@ We've made 3 guides related to this.
 
 ??? question "SDR (no WEBDL) - [Click to show/hide]"
 
-    {! include-markdown "../../includes/cf-descriptions/sdr-no-webdl.md" !}
+    {! include-markdown "../../includes/cf-descriptions/sdr-no-webdl-sonarr.md" !}
 
 ??? example "JSON - [Click to show/hide]"
 

diff --git a/includes/cf-descriptions/dv-hdr10.md b/includes/cf-descriptions/dv-hdr10.md
@@ -1,4 +1,4 @@
-_This Custom Format will only match on_ `DV HDR10`
+This Custom Format will only match on `DV HDR10`
 
 This format provides Dolby Vision _with_ HDR10 fallback.
 You will find this mainly with:

diff --git a/includes/cf-descriptions/sdr-no-webdl-radarr-warning.md b/includes/cf-descriptions/sdr-no-webdl-radarr-warning.md
@@ -0,0 +1 @@
+!!! Danger "If you have also added [{{ radarr['cf']['sdr']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#sdr){:target="\_blank" rel="noopener noreferrer"} to your Radarr,<br>then one of them should be scored as `0` in your quality profile."
diff --git a/includes/cf-descriptions/sdr-no-webdl.md → ...es/cf-descriptions/sdr-no-webdl-radarr.md b/includes/cf-descriptions/sdr-no-webdl.md → ...es/cf-descriptions/sdr-no-webdl-radarr.md
@@ -1 +1,3 @@
 This will prevent grabbing UHD/4k Remux and Bluray encode releases without HDR Formats. - i.e., SDR WEB releases will still be allowed since 4K SDR WEB releases can often look better than the 1080p version due to the improved bitrate.
+
+{! include-markdown "../../includes/cf-descriptions/sdr-no-webdl-radarr-warning.md" !}
diff --git a/includes/cf-descriptions/sdr-no-webdl-sonarr-warning.md b/includes/cf-descriptions/sdr-no-webdl-sonarr-warning.md
@@ -0,0 +1 @@
+!!! Danger "If you have also added [{{ sonarr['cf']['sdr']['name'] }}](/Sonarr/sonarr-collection-of-custom-formats/#sdr){:target="\_blank" rel="noopener noreferrer"} to your Sonarr,<br>then one of them should be scored as `0` in your quality profile."
diff --git a/includes/cf-descriptions/sdr-no-webdl-sonarr.md b/includes/cf-descriptions/sdr-no-webdl-sonarr.md
@@ -0,0 +1,3 @@
+This will prevent grabbing UHD/4k Remux and Bluray encode releases without HDR Formats. - i.e., SDR WEB releases will still be allowed since 4K SDR WEB releases can often look better than the 1080p version due to the improved bitrate.
+
+{! include-markdown "../../includes/cf-descriptions/sdr-no-webdl-sonarr-warning.md" !}
diff --git a/includes/cf-descriptions/x265-hd-radarr-warning.md b/includes/cf-descriptions/x265-hd-radarr-warning.md
@@ -0,0 +1 @@
+!!! Danger "If you have also added [{{ radarr['cf']['x265-no-hdrdv']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#x265-no-hdrdv){:target="\_blank" rel="noopener noreferrer"} to your Radarr,<br>then one of them should be scored as `0` in your quality profile."
diff --git a/includes/cf-descriptions/x265-hd-radarr.md b/includes/cf-descriptions/x265-hd-radarr.md
@@ -0,0 +1,9 @@
+This blocks all 720/1080p (HD) releases that are encoded in x265.
+
+In your quality profile use the following score for this Custom Format: `{{ radarr['cf']['x265-hd']['trash_scores']['default'] }}`
+
+??? question "Why block 720/1080p encodes in x265? - [Click to show/hide]"
+
+    --8<-- "includes/docker/x265.md"
+
+{! include-markdown "../../includes/cf-descriptions/x265-hd-radarr-warning.md" !}
diff --git a/includes/cf-descriptions/x265-hd-sonarr-warning.md b/includes/cf-descriptions/x265-hd-sonarr-warning.md
@@ -0,0 +1 @@
+!!! Danger "If you have also added [{{ sonarr['cf']['x265-no-hdrdv']['name'] }}](/Sonarr/sonarr-collection-of-custom-formats/#x265-no-hdrdv){:target="\_blank" rel="noopener noreferrer"} to your Sonarr,<br>then one of them should be scored as `0` in your quality profile."
diff --git a/includes/cf-descriptions/x265-hd-sonarr.md b/includes/cf-descriptions/x265-hd-sonarr.md
@@ -0,0 +1,9 @@
+This blocks all 720/1080p (HD) releases that are encoded in x265.
+
+In your quality profile use the following score for this Custom Format: `{{ sonarr['cf']['x265-hd']['trash_scores']['default'] }}`
+
+??? question "Why block 720/1080p encodes in x265? - [Click to show/hide]"
+
+    --8<-- "includes/docker/x265.md"
+
+{! include-markdown "../../includes/cf-descriptions/x265-hd-sonarr-warning.md" !}
diff --git a/includes/cf-descriptions/x265-no-hdrdv-radarr-warning.md b/includes/cf-descriptions/x265-no-hdrdv-radarr-warning.md
@@ -0,0 +1 @@
+!!! Danger "If you have also added [{{ radarr['cf']['x265-hd']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#x265-hd){:target="\_blank" rel="noopener noreferrer"} to your Radarr,<br>then one of them should be scored as `0` in your quality profile."
diff --git a/includes/cf-descriptions/x265-no-hdrdv-radarr.md b/includes/cf-descriptions/x265-no-hdrdv-radarr.md
@@ -0,0 +1,11 @@
+This blocks most 720/1080p (HD) releases that are encoded in x265, **But it will allow 720/1080p x265 releases if they have HDR and/or DV**
+
+*Since some NF releases won't be released as 4k, this allows you to still have the DV/HDR releases.*
+
+In your quality profile use the following score for this Custom Format: `{{ radarr['cf']['x265-no-hdrdv']['trash_scores']['default'] }}`
+
+??? question "Why block 720/1080p encodes in x265? - [Click to show/hide]"
+
+    --8<-- "includes/docker/x265.md"
+
+{! include-markdown "../../includes/cf-descriptions/x265-no-hdrdv-radarr-warning.md" !}
diff --git a/includes/cf-descriptions/x265-no-hdrdv-sonarr-warning.md b/includes/cf-descriptions/x265-no-hdrdv-sonarr-warning.md
@@ -0,0 +1 @@
+!!! Danger "If you have also added [{{ sonarr['cf']['x265-hd']['name'] }}](/Sonarr/sonarr-collection-of-custom-formats/#x265-hd){:target="\_blank" rel="noopener noreferrer"} to your Sonarr,<br>then one of them should be scored as `0` in your quality profile."
diff --git a/includes/cf-descriptions/x265-no-hdrdv-sonarr.md b/includes/cf-descriptions/x265-no-hdrdv-sonarr.md
@@ -0,0 +1,11 @@
+This blocks most 720/1080p (HD) releases that are encoded in x265, **But it will allow 720/1080p x265 releases if they have HDR and/or DV**
+
+*Since some NF releases won't be released as 4k, this allows you to still have the DV/HDR releases.*
+
+In your quality profile use the following score for this Custom Format: `{{ sonarr['cf']['x265-no-hdrdv']['trash_scores']['default'] }}`
+
+??? question "Why block 720/1080p encodes in x265? - [Click to show/hide]"
+
+    --8<-- "includes/docker/x265.md"
+
+{! include-markdown "../../includes/cf-descriptions/x265-no-hdrdv-sonarr-warning.md" !}
diff --git a/includes/cf/radarr-optional-uhd.md b/includes/cf/radarr-optional-uhd.md
@@ -1,9 +1,16 @@
 ??? abstract "Optional UHD - [Click to show/hide]"
 
-    | Custom Format                                                                                                     |                             Score                             | Trash ID                                       |
-    | ----------------------------------------------------------------------------------------------------------------- | :-----------------------------------------------------------: | ---------------------------------------------- |
-    | [{{ radarr['cf']['sdr']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#sdr)                             |     {{ radarr['cf']['sdr']['trash_scores']['default'] }}      | {{ radarr['cf']['sdr']['trash_id'] }}          |
-    | [{{ radarr['cf']['sdr-no-webdl']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#sdr-no-webdl) :warning: | {{ radarr['cf']['sdr-no-webdl']['trash_scores']['default'] }} | {{ radarr['cf']['sdr-no-webdl']['trash_id'] }} |
+    !!! tip "I recommend using the following Custom Formats"
+
+        - **For details on "Why" and a potential warning :warning: please see the notes below.**
+        - `x265 (no HDR/DV)` over the `x265 (HD)`
+        - `SDR (no WEBDL)` over the `SDR`
+
+    | Custom Format                                                                                                       |                             Score                              | Trash ID                                        |
+    | ------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------: | ----------------------------------------------- |
+    | [{{ radarr['cf']['sdr']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#sdr)                               |      {{ radarr['cf']['sdr']['trash_scores']['default'] }}      | {{ radarr['cf']['sdr']['trash_id'] }}           |
+    | [{{ radarr['cf']['sdr-no-webdl']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#sdr-no-webdl) :warning:   | {{ radarr['cf']['sdr-no-webdl']['trash_scores']['default'] }}  | {{ radarr['cf']['sdr-no-webdl']['trash_id'] }}  |
+    | [{{ radarr['cf']['x265-no-hdrdv']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#x265-no-hdrdv) :warning: | {{ radarr['cf']['x265-no-hdrdv']['trash_scores']['default'] }} | {{ radarr['cf']['x265-no-hdrdv']['trash_id'] }} |
 
     ---
 
@@ -12,4 +19,8 @@
     - **{{ radarr['cf']['sdr']['name'] }}:** This will prevent grabbing UHD/4k releases without HDR Formats.
     - **{{ radarr['cf']['sdr-no-webdl']['name'] }}:** This will prevent grabbing UHD/4k Remux and Bluray encode releases without HDR Formats. - i.e., SDR WEB releases will still be allowed since 4K SDR WEB releases can often look better than the 1080p version due to the improved bitrate.
 
-        !!! Danger "Don't use this together with [{{ radarr['cf']['sdr']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#sdr), Only ever include one of them :warning:"
+        {! include-markdown "../../includes/cf-descriptions/sdr-no-webdl-radarr-warning.md" !}
+
+    - **{{ radarr['cf']['x265-no-hdrdv']['name'] }}:** This blocks 720/1080p (HD) releases that are encoded in x265, **But it will allow x265 releases if they have HDR and/or DV**
+
+        {! include-markdown "../../includes/cf-descriptions/x265-no-hdrdv-radarr-warning.md" !}
diff --git a/includes/cf/radarr-optional.md b/includes/cf/radarr-optional.md
@@ -8,7 +8,6 @@
     | [{{ radarr['cf']['obfuscated']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#obfuscated)                 |   {{ radarr['cf']['obfuscated']['trash_scores']['default'] }}    | {{ radarr['cf']['obfuscated']['trash_id'] }}      |
     | [{{ radarr['cf']['retags']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#retags)                         |     {{ radarr['cf']['retags']['trash_scores']['default'] }}      | {{ radarr['cf']['retags']['trash_id'] }}          |
     | [{{ radarr['cf']['scene']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#scene)                           |      {{ radarr['cf']['scene']['trash_scores']['default'] }}      | {{ radarr['cf']['scene']['trash_id'] }}           |
-    | [{{ radarr['cf']['x265-no-hdrdv']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#x265-no-hdrdv) :warning: |  {{ radarr['cf']['x265-no-hdrdv']['trash_scores']['default'] }}  | {{ radarr['cf']['x265-no-hdrdv']['trash_id'] }}   |
 
     ---
 
@@ -21,12 +20,3 @@
     - **{{ radarr['cf']['obfuscated']['name'] }}:** [*Optional*] Use these only if you wish to avoid renamed releases.
     - **{{ radarr['cf']['retags']['name'] }}:** [*Optional*] Use this if you want to avoid retagged releases. Retagged releases often are not consistent with the quality of the original group's release.
     - **{{ radarr['cf']['scene']['name'] }}:** [*Optional*] Use this only if you want to avoid SCENE releases.
-    - **{{ radarr['cf']['x265-no-hdrdv']['name'] }}:** This blocks 720/1080p (HD) releases that are encoded in x265. - More info [HERE](/Misc/x265-4k/){:target="_blank" rel="noopener noreferrer"}.
-
-        **But it will allow x265 releases if they have HDR and/or DV**
-
-        *Being that some NF releases won't be released as 4k, but you want to have DV/HDR releases.*
-
-        In your quality profile use the following score for this Custom Format: `{{ radarr['cf']['x265-no-hdrdv']['trash_scores']['default'] }}`
-
-        !!! Danger "Don't use this together with [{{ radarr['cf']['x265-hd']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#x265-hd), Only ever include one of them :warning:"
diff --git a/includes/cf/radarr-unwanted-uhd.md b/includes/cf/radarr-unwanted-uhd.md
@@ -17,9 +17,9 @@
     - **{{ radarr['cf']['br-disk']['name'] }} :** This is a custom format to help Radarr recognize & ignore BR-DISK (ISO's and Blu-ray folder structure) in addition to the standard BR-DISK quality.
     - **{{ radarr['cf']['lq']['name'] }}:** A collection of known Low Quality groups that are often banned from the the top trackers because the lack of quality or other reasons.
     - **{{ radarr['cf']['lq-release-title']['name'] }}:** A collection of terms seen in the titles of Low Quality releases that are not captured by using a release group name.
-    - **{{ radarr['cf']['x265-hd']['name'] }}:** This blocks 720/1080p (HD) releases that are encoded in x265. - More info [HERE](/Misc/x265-4k/){:target="_blank" rel="noopener noreferrer"}.
+    - **{{ radarr['cf']['x265-hd']['name'] }}:** This blocks 720/1080p (HD) releases that are encoded in x265.
 
-        !!! Danger "Don't use this together with [{{ radarr['cf']['x265-no-hdrdv']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#x265-no-hdrdv), Only ever include one of them :warning:"
+        {! include-markdown "../../includes/cf-descriptions/x265-hd-radarr-warning.md" !}
 
     - **{{ radarr['cf']['3d']['name'] }}:** Is 3D still a thing for home use ?
     - **{{ radarr['cf']['upscaled']['name'] }}:** A custom format to prevent Radarr from grabbing upscaled releases.

diff --git a/includes/cf/radarr-unwanted.md b/includes/cf/radarr-unwanted.md
@@ -16,9 +16,9 @@
     - **{{ radarr['cf']['br-disk']['name'] }} :** This is a custom format to help Radarr recognize & ignore BR-DISK (ISO's and Blu-ray folder structure) in addition to the standard BR-DISK quality.
     - **{{ radarr['cf']['lq']['name'] }}:** A collection of known Low Quality groups that are often banned from the the top trackers because the lack of quality or other reasons.
     - **{{ radarr['cf']['lq-release-title']['name'] }}:** A collection of terms seen in the titles of Low Quality releases that are not captured by using a release group name.
-    - **{{ radarr['cf']['x265-hd']['name'] }}:** This blocks 720/1080p (HD) releases that are encoded in x265. - More info [HERE](/Misc/x265-4k/){:target="_blank" rel="noopener noreferrer"}.
+    - **{{ radarr['cf']['x265-hd']['name'] }}:** This blocks 720/1080p (HD) releases that are encoded in x265.
 
-        !!! Danger "Don't use this together with [{{ radarr['cf']['x265-no-hdrdv']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#x265-no-hdrdv), Only ever include one of them :warning:"
+        {! include-markdown "../../includes/cf-descriptions/x265-hd-radarr-warning.md" !}
 
     - **{{ radarr['cf']['3d']['name'] }}:** Is 3D still a thing for home use ?
     - **{{ radarr['cf']['extras']['name'] }}:** Blocks releases that only contain extras
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		!!! Danger "If you have also added [{{ radarr['cf']['sdr']['name'] }}](/Radarr/Radarr-collection-of-custom-formats/#sdr){:target="\_blank" rel="noopener noreferrer"} to your Radarr,<br>then one of them should be scored as `0` in your quality profile."
Original file line number	Diff line number	Diff line change
		@@ -1 +1,3 @@
		This will prevent grabbing UHD/4k Remux and Bluray encode releases without HDR Formats. - i.e., SDR WEB releases will still be allowed since 4K SDR WEB releases can often look better than the 1080p version due to the improved bitrate.

		{! include-markdown "../../includes/cf-descriptions/sdr-no-webdl-radarr-warning.md" !}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		!!! Danger "If you have also added [{{ sonarr['cf']['sdr']['name'] }}](/Sonarr/sonarr-collection-of-custom-formats/#sdr){:target="\_blank" rel="noopener noreferrer"} to your Sonarr,<br>then one of them should be scored as `0` in your quality profile."
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		This will prevent grabbing UHD/4k Remux and Bluray encode releases without HDR Formats. - i.e., SDR WEB releases will still be allowed since 4K SDR WEB releases can often look better than the 1080p version due to the improved bitrate.

		{! include-markdown "../../includes/cf-descriptions/sdr-no-webdl-sonarr-warning.md" !}