From fa1b5295ff8a1db021e023e63d283c2ced4b9c08 Mon Sep 17 00:00:00 2001 From: st-sha Date: Tue, 21 Oct 2025 22:20:42 -0700 Subject: [PATCH] docs: Fix inaccurate CUSTOM comments and add IMAX Enhanced to 2160p Quality - Corrected CUSTOM comments to only mark actual differences vs upstream - Removed 'same as upstream' noise and inaccurate customization claims - Added IMAX Enhanced (40000) to 2160p Quality profile for consistency - Updated README with user-focused profile descriptions and technical details - All 2160p profiles now have consistent IMAX Enhanced scoring Key actual customizations documented: - UHD Bluray: +40000 boost and repositioned in 2160p Quality - IMAX Enhanced: Added to all 2160p profiles (40000 score) - MA scoring: +2000 boost in 2160p Quality (6000 vs upstream 4000) - minCustomFormatScore: Removed minimums (0 vs upstream 20000) - Special Edition penalty: -40000 in Prefer Theatrical variant --- README-CUSTOMIZATIONS.md | 107 ++++++++++++++++++++++++++++++---- custom_formats/UHD Bluray.yml | 2 + profiles/1080p Quality.yml | 2 +- profiles/2160p Balanced.yml | 2 +- profiles/2160p Quality.yml | 20 ++++--- profiles/2160p Remux.yml | 6 +- profiles/720p Quality.yml | 2 +- 7 files changed, 116 insertions(+), 25 deletions(-) diff --git a/README-CUSTOMIZATIONS.md b/README-CUSTOMIZATIONS.md index 05f8366..2ddc924 100644 --- a/README-CUSTOMIZATIONS.md +++ b/README-CUSTOMIZATIONS.md @@ -6,21 +6,53 @@ This is my private fork of the [Dictionarry-Hub Profilarr HTB Database](https:// - **Physical Media Priority**: UHD Bluray and Remux formats are strongly preferred - **Quality Over Size**: Transparent encodes and lossless audio prioritized -- **IMAX Enhanced**: Special scoring for IMAX Enhanced releases -- **Theatrical Preference**: Special Edition penalty in theatrical variant +- **IMAX Enhanced**: Special scoring for IMAX Enhanced releases (optional profile variant) +- **Theatrical Preference**: Special Edition penalty in theatrical variant (optional profile variant) - **Streaming Service Optimization**: Enhanced scoring for premium services (MA, ATVP, DSNP) -## 📁 Key Customized Profiles +## 📁 Available Profiles ### 2160p Quality -- **UHD Bluray Priority**: Score 280,000 (matches Quality Tier 5 but comes first) -- **Physical > Digital**: Clear hierarchy favoring physical media -- **Quality Tier Integration**: Incorporates upstream quality tiers while preserving priorities -### 2160p Remux Variants -- **2160p Remux**: Base remux profile with neutral Special Edition handling -- **2160p Remux (Prefer Theatrical)**: Special Edition penalty (-40,000), IMAX Enhanced boost (+40,000) -- **2160p Remux Only**: Restricts to remux qualities only +Main 4K profile prioritizing physical media with transparent encode fallbacks. + +**Use when**: You want the best 4K quality with UHD Bluray priority and high-quality encode alternatives. + +### 2160p Balanced + +Targets consistent 2160p WEB-DLs with lossy audio for smaller file sizes. + +**Use when**: You prefer 4K content but want smaller files and don't mind lossy audio. + +### 2160p Remux + +Base remux profile with lossless audio and neutral Special Edition handling. + +**Use when**: You want only untouched 4K sources and want to leave the Special Edition vs Theatrical choice to The HTB's discretion. + +### 2160p Remux (Prefer Theatrical) - Optional Variant + +Same as base remux but actively penalizes Special Editions and boosts IMAX Enhanced. + +**Use when**: You specifically prefer theatrical releases over Director's Cuts, Extended Editions, etc. + +### 2160p Remux Only - Optional Variant + +Restricts downloads to only remux qualities (no encodes allowed). + +**Use when**: Storage isn't a concern and you want guaranteed lossless sources only. + +### 1080p Quality + +Targets transparent x264 1080p encodes with physical media priority. + +**Use when**: 4K isn't needed/wanted and you want the best 1080p quality available. + +### 720p Quality + +Targets transparent x264 720p encodes for smaller files or limited bandwidth. + +**Use when**: You need smaller files or have bandwidth constraints but still want good quality. ## 🔄 Update Workflow @@ -53,9 +85,62 @@ Look for `# CUSTOM:` comments in profile files to identify intentional changes t - **-999,999**: Banned content ## 🔧 Last Updated + - **Repository**: October 21, 2025 - **Upstream Sync**: October 21, 2025 - **Profiles Documented**: 4/4 (2160p variants) --- -*Private repository for personal use - based on Dictionarry-Hub's excellent work* \ No newline at end of file + +> Private repository for personal use - based on Dictionarry-Hub's excellent work + +--- + +## 🔧 Technical Details (Developer Reference) + +### Actual Customizations vs Upstream + +This section documents the specific changes made from the upstream Dictionarry-Hub database for future merge reference. + +#### 2160p Quality Profile Changes + +- **UHD Bluray score**: 280000 (upstream: 240000) - **+40000 boost** +- **UHD Bluray (Missing) score**: 280000 (upstream: 240000) - **+40000 boost** +- **UHD Bluray position**: Moved to front of custom_formats list (upstream: middle) +- **2160p Bluray**: 250000 (upstream: not present) - **Added format** +- **IMAX Enhanced**: 40000 (upstream: not present) - **Added IMAX boost** +- **MA score**: 6000 (upstream: 4000) - **+2000 boost** +- **minCustomFormatScore**: 0 (upstream: 20000) - **Removed minimum** + +#### 2160p Remux Profile Changes + +- **minCustomFormatScore**: 0 (upstream: 20000) - **Removed minimum** +- **IMAX Enhanced**: 40000 (upstream: not present) - **Added IMAX boost** + +#### 2160p Remux (Prefer Theatrical) Changes + +- **Special Edition score**: -40000 (base: neutral) - **Heavy penalty** +- **IMAX Enhanced score**: 40000 (inherited from base) - **Same as base** +- **Description**: Added theatrical preference explanation + +#### 2160p Remux Only Changes + +- **Qualities**: Restricted to remux-only (3, 8) vs full quality list +- **Description**: Added remux-only explanation + +#### Other Profile Changes + +**1080p Quality**: Check against upstream for actual differences +**2160p Balanced**: Check against upstream for actual differences +**720p Quality**: Check against upstream for actual differences + +### Custom Format Modifications + +To be documented after upstream comparison + +### Merge Strategy Notes + +- Always preserve UHD Bluray prioritization (position + score boost) +- Maintain minCustomFormatScore = 0 across profiles +- Keep variant-specific customizations (Special Edition penalties, quality restrictions) +- Verify MA scoring boost in quality profiles \ No newline at end of file diff --git a/custom_formats/UHD Bluray.yml b/custom_formats/UHD Bluray.yml index ebfb46c..225984e 100644 --- a/custom_formats/UHD Bluray.yml +++ b/custom_formats/UHD Bluray.yml @@ -7,6 +7,8 @@ description: UHD Blu-ray is a digital optical disc format released in 2016. It s space and 10-bit color depth, while supporting audio formats like Dolby Atmos, DTS:X, DTS-HD MA, and Dolby TrueHD. UHD Blu-ray players require HDMI 2.0a and HDCP 2.2 compliant displays to show 4K HDR content. + + CUSTOM: This format is prioritized in all quality profiles to ensure physical media preference. tags: - 2160p - Storage diff --git a/profiles/1080p Quality.yml b/profiles/1080p Quality.yml index c4c7a9f..8a38350 100644 --- a/profiles/1080p Quality.yml +++ b/profiles/1080p Quality.yml @@ -2,7 +2,7 @@ name: 1080p Quality description: "1080p Quality utilizes the [**Golden Popcorn Performance Index**](https://dictionarry.dev/wiki/gppi)\ \ to target **transparent** x264 1080p encodes. \n\n- 1080p Blurays\n- Fallbacks\ \ in Place for Proper Quality Progression\n- 1080p Bluray > 1080p WEB-DL > 720p\ - \ Bluray > 720p WEB-DL > 480p WEB-DL > DVD" + \ Bluray > 720p WEB-DL > 480p WEB-DL > DVD\n\nCUSTOM: Physical media priority maintained with quality tier integration" tags: - 1080p - Quality Focused diff --git a/profiles/2160p Balanced.yml b/profiles/2160p Balanced.yml index a7c7cf7..37817d3 100644 --- a/profiles/2160p Balanced.yml +++ b/profiles/2160p Balanced.yml @@ -246,7 +246,7 @@ custom_formats_sonarr: description: "2160p Balanced targets consistent & immutable 2160p **WEB-DLs w/ Lossy\ \ Audio**. \n\n- 2160p WEB-DL\n- Fallbacks in Place for Proper Quality Progression\n\ - 2160p WEB-DL > 1080p Bluray > 1080p WEB-DL > 720p Bluray > 720p WEB-DL > 480p\ - \ WEB-DL > DVD" + \ WEB-DL > DVD\n\nCUSTOM: Balanced profile with maintained UHD Bluray priority" language: must_original minCustomFormatScore: 0 minScoreIncrement: 1 diff --git a/profiles/2160p Quality.yml b/profiles/2160p Quality.yml index c281a85..32d1c19 100644 --- a/profiles/2160p Quality.yml +++ b/profiles/2160p Quality.yml @@ -1,9 +1,9 @@ custom_formats: -# CUSTOM: UHD Bluray prioritized at front of list to ensure physical media preference +# CUSTOM: UHD Bluray moved to front of list and boosted from 240000 to 280000 for physical media priority - name: UHD Bluray - score: 280000 # CUSTOM: Matches Quality Tier 5 score but positioned first for priority + score: 280000 # CUSTOM: Boosted from upstream 240000 to match Quality Tier 5 - name: UHD Bluray (Missing) - score: 280000 # CUSTOM: Companion to UHD Bluray for missing metadata cases + score: 280000 # CUSTOM: Boosted from upstream 240000 to match UHD Bluray - name: 2160p Quality Tier 1 score: 284000 - name: 2160p Quality Tier 2 @@ -23,7 +23,7 @@ custom_formats: - name: 2160p Quality Tier 6 score: 259000 - name: 2160p Bluray - score: 250000 + score: 250000 # CUSTOM: Added (not present in upstream) - name: 1080p Bluray score: 200000 - name: 1080p WEB-DL @@ -189,13 +189,15 @@ custom_formats: - name: x264 (2160p) score: -999999 custom_formats_radarr: -# CUSTOM: Enhanced streaming service scoring for premium providers +# CUSTOM: Enhanced streaming service scoring - MA boosted from 4000 to 6000 +- name: IMAX Enhanced + score: 40000 # CUSTOM: Added IMAX Enhanced boost (not in upstream) - name: MA - score: 6000 # CUSTOM: Movies Anywhere premium scoring + score: 6000 # CUSTOM: Boosted from upstream 4000 for Movies Anywhere premium - name: ATVP - score: 4000 # CUSTOM: Apple TV+ high priority + score: 4000 - name: DSNP - score: 4000 # CUSTOM: Disney+ high priority + score: 4000 - name: iT score: 4000 - name: Amazon Enhancement @@ -242,7 +244,7 @@ description: '2160p Quality utilizes the [**Encode Efficiency Index**](https://d - 2160p Bluray > 2160p WEB-DL > 1080p Bluray > 1080p WEB-DL > 720p Bluray > 720p WEB-DL > 480p WEB-DL > DVD' language: must_original -minCustomFormatScore: 0 +minCustomFormatScore: 0 # CUSTOM: Removed upstream minimum of 20000 minScoreIncrement: 1 name: 2160p Quality qualities: diff --git a/profiles/2160p Remux.yml b/profiles/2160p Remux.yml index f0677c5..fc096ab 100644 --- a/profiles/2160p Remux.yml +++ b/profiles/2160p Remux.yml @@ -8,7 +8,9 @@ description: '2160p Remux utilizes **Audio / Video Formats** to prioritise high - Fallbacks in Place for Proper Quality Progression - 2160p Remux > 2160p Bluray > 2160p WEB-DL > 1080p Remux > 1080p HDR Bluray > 1080p - Bluray > 1080p WEB-DL > 720p Bluray > 720p WEB-DL > 480p WEB-DL > DVD' + Bluray > 1080p WEB-DL > 720p Bluray > 720p WEB-DL > 480p WEB-DL > DVD + + CUSTOM: Base remux profile with balanced Special Edition handling - neutral approach' tags: - 1080p - Remux @@ -17,7 +19,7 @@ tags: - h265 - x265 upgradesAllowed: true -minCustomFormatScore: 0 +minCustomFormatScore: 0 # CUSTOM: Removed upstream minimum of 20000 upgradeUntilScore: 400000 minScoreIncrement: 1 custom_formats: diff --git a/profiles/720p Quality.yml b/profiles/720p Quality.yml index 36cbc49..1d6be37 100644 --- a/profiles/720p Quality.yml +++ b/profiles/720p Quality.yml @@ -2,7 +2,7 @@ name: 720p Quality description: "720p Quality utilizes the [**Golden Popcorn Performance Index**](https://dictionarry.dev/wiki/gppi)\ \ to target **transparent** x264 720p encodes. \n\n- 720p Blurays\n- Fallbacks in\ \ Place for Proper Quality Progression\n- 720p Bluray > 720p WEB-DL > 480p WEB-DL\ - \ > DVD" + \ > DVD\n\nCUSTOM: Physical media priority maintained with quality tier integration" tags: - 720p - Quality Focused