From 0bcc7c8b9457b77276843c08dcfe034acf9640b4 Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Wed, 26 Feb 2025 06:11:19 +0000 Subject: [PATCH] Update bundles --- bundles/custom_formats.json | 710 +++++++++++++++++++++- bundles/dev_logs.json | 14 +- bundles/profiles.json | 42 +- bundles/regex_patterns.json | 1111 ++++++++++++++++++++++++++++++++++- bundles/version.json | 2 +- bundles/wiki.json | 12 +- 6 files changed, 1861 insertions(+), 30 deletions(-) diff --git a/bundles/custom_formats.json b/bundles/custom_formats.json index ffed854..256495e 100644 --- a/bundles/custom_formats.json +++ b/bundles/custom_formats.json @@ -5252,7 +5252,7 @@ { "name": "Groups", "negate": false, - "pattern": "(?<=^|[\\s.-])VECTOR|BiTOR|DepraveD|SasukeducK|tarunk9c|jennaortegaUHD|VisionXpert\\b", + "pattern": "(?<=^|[\\s.-])VECTOR|BiTOR|DepraveD|SasukeducK|tarunk9c|jennaortegaUHD|VisionXpert|Flights\\b", "required": true, "type": "release_title" } @@ -6278,6 +6278,714 @@ "tests": [], "_id": "Scene" }, + { + "name": "Special Edition (Unwanted)", + "description": "Matches Special Edition only for specific movies where the theatrical edition is preferred.\n\n- **Note:** This custom format doesn't work because release titles only match after the parsed movie title: https://github.com/Radarr/Radarr/issues/4859", + "tags": [ + "Edition", + "Unwanted" + ], + "conditions": [ + { + "name": "Special Edition", + "negate": false, + "pattern": "(? Website sees its data is stale -> Website rebuilds itself with new data -> Santiago smiles in not needing to do anything\n\nThis all ties into the whole \"write once\" philosophy that I instilled with Profilarr and has made development much easier. There are still quite a few layout issues and perhaps a devlog refactor I need to fit in somewhere, but I'm happy to share it with you guys as it is.\n\n[Website 2.0](https://dictionarry.dev/)\n\n![website2.0](https://i.imgur.com/eORTwml.png)\n\nThe old site will go down soon, sorry if I broke anyone's workflows D:\n\n### Profile Selector?\n\nThis idea has gone through many iterations since i started Dictionarry last year.\n\n1. A static flowchart with not nearly enough information / choice: https://github.com/santiagosayshey/website/blob/030f3631b4f6fffdb7fa9f4696e5d12defc84a46/docs/Profiles/flowchart.png\n2. The \"Profile Selector\" (terrible name): https://selectarr.pages.dev/\n3. Frankenstein's triangle: [Discord Link](https://discord.com/channels/1202375791556431892/1246504849265266738/1246536424925171925)\n\nFrankenstein's triangle was supposed to be what i shipped with the new website (and I actually finished it too!). It worked by calculating the area of the efficiency/quality/compatibility triangle using some formula named after some guy i forget, to guesstimate user choice based on their previous selection. It did this by normalizing the \"score\" of each profile on each of it's axes and finding the best fitting triangle that used the axis that was changed.\n\nResults were pretty good but I felt that it abstracted _too much_ of what made any user choice meaningful so I decided to scrap it.\n\n### Profile Builder!\n\nIn it's place is the \"Profile Builder\" (maybe also a terrible name). It still attempts to abstract audio/video down into more quantifiable groupings, but limits itself to explanations of certain things where more abstraction is detrimental. It's pretty self explanatory once you use it, but basically you choose through increasingly niche groupings -> resolution -> compression -> encode type -> codec -> HDR. At each step, a list of recommended profiles will be shown. I think this new system helps to fix the \"trying to get the profile I want\" issue as it starts pretty broad and gets increasingly more specific the more things you choose. It's up now, give it a playwith; let me know if its good / bad / needs changes: [Profile Buider](https://dictionarry.dev/builder)\n\n![Profile Builder](https://i.imgur.com/ka8KSHl.png)\n\n## Encode Efficiency Index\n\nHere we go, meat and potatoes. This is another release group metric just like the Golden Popcorn Performance Index. Heres's the play-by-play:\n\n- It evaluates release groups on their average compression ratio (how big their encode is compared to a source), to discern quality and/or efficiency.\n- It can discern transparency by targeting ratios at which a codec begins to \"saturate\"\n- It can discern efficiency by targeting ratios at which a codec reaches it's \"efficiency apex\"\n\nThis is a heavily watered down explanation of the metric, you can read about it (with examples), in very heavy detail [here](https://dictionarry.dev/wiki/EEi). Months of research and iteration has gone into this, and I really think this is Dictionarry's biggest asset so far. When AV1 profiles become a thing, this metric is ready for it.\n\n#### No More Parsing Codecs!!!!\n\nIf you parse the efficiency of a release group directly, then you know youre getting something at a file size you want. This means we don't have to use h265 / x265 as a ridiculous proxy baseline to find content we want anymore. We can just downrank all h264 instead which is much more reliable\n\n#### 2160p Quality (Encode) Profile + Release Group Tierlist!!!!!!!!\n\nUsing EEI, we target 4k release groups at 55% target ratio to discern transparency. No golden popcorns needed, no complex trump parsing crap. No \"popular\" vote. Whenever something isn't documented, we simply add that movie / tv show to the data source and groupings update automatically. It's almost like magic.\n\nThis metric has made the 2160p Quality profile possible and i dare say it's the most comprehensive one I've worked on thus far. Give the quality profile and tier lists a read here:\n\n- [216p Quality Profile](https://dictionarry.dev/profiles/2160p-quality)\n- [2160p Quality Release Group Tiers](https://dictionarry.dev/tiers/2160p/quality)\n\n#### Thanks\n\n- Thanks to @seraphys for helping out with the profile creation / giving constant feedback.\n- Thanks to @erphise for being a tester / the catalyst for the creation of this metric. If they hadn't been testing out the HEVC profile, we never would have talked about compression ratios which never meant I got the idea for the metric in the first place.\n\nShow them some love.\n\n## Profilarr\n\nAlmost done, I took a break for a couple weeks to finish up the website but I'm gonna get rolling again soon. I just finalized authentication, database migrations and the pull module. The only major thing left is getting everything ready for production. This means setting up the docker image, unraid template, etc, etc. It's hard to say how long this is gonna take since I'm basically learning it all on the fly so bare with me on this. But, it's almost done and a beta test will be out soon (hopefully)", - "last_modified": "2025-02-26T06:03:23.008624+00:00", + "last_modified": "2025-02-26T06:11:17.505985+00:00", "title": "Website 2.0", "slug": "website2.0", "author": "santiagosayshey", diff --git a/bundles/profiles.json b/bundles/profiles.json index 2f0889e..8ce3be8 100644 --- a/bundles/profiles.json +++ b/bundles/profiles.json @@ -137,6 +137,10 @@ "name": "Blu-ray", "score": 10 }, + { + "name": "Special Edition", + "score": 10 + }, { "name": "WEBRip", "score": 10 @@ -485,6 +489,10 @@ "name": "HDR10 (Missing) (1080p)", "score": 10 }, + { + "name": "Special Edition", + "score": 10 + }, { "name": "WEBRip", "score": 10 @@ -772,6 +780,10 @@ "name": "Blu-ray", "score": 10 }, + { + "name": "Special Edition", + "score": 10 + }, { "name": "WEBRip", "score": 10 @@ -1043,6 +1055,10 @@ "name": "Roku", "score": 10 }, + { + "name": "Special Edition", + "score": 10 + }, { "name": "Repack3", "score": 7 @@ -1195,13 +1211,6 @@ "description": "1080p Blu-ray disc content remuxed into a playable file format" }, "language": "must_original", - "tweaks": { - "preferFreeleech": false, - "allowLosslessAudio": true, - "allowDVNoFallback": false, - "allowBleedingEdgeCodecs": false, - "allowPrereleases": false - }, "_id": "1080p Remux" }, { @@ -1292,6 +1301,10 @@ "name": "1080p Quality Tier 2", "score": 50 }, + { + "name": "Special Edition", + "score": 50 + }, { "name": "1080p Quality Tier 3", "score": 40 @@ -1721,6 +1734,10 @@ "name": "1080p Quality Tier 2", "score": 50 }, + { + "name": "Special Edition", + "score": 50 + }, { "name": "1080p Quality Tier 3", "score": 40 @@ -2084,6 +2101,10 @@ "name": "DTS-HD MA", "score": 50 }, + { + "name": "Special Edition", + "score": 50 + }, { "name": "TrueHD", "score": 50 @@ -2320,13 +2341,6 @@ "description": "4K Ultra HD Blu-ray disc content remuxed into a playable file format" }, "language": "must_original", - "tweaks": { - "preferFreeleech": true, - "allowLosslessAudio": true, - "allowDVNoFallback": false, - "allowBleedingEdgeCodecs": false, - "allowPrereleases": false - }, "_id": "2160p Remux" } ] \ No newline at end of file diff --git a/bundles/regex_patterns.json b/bundles/regex_patterns.json index aa37192..c46b214 100644 --- a/bundles/regex_patterns.json +++ b/bundles/regex_patterns.json @@ -816,6 +816,410 @@ "tests": null, "_id": "BeiTai" }, + { + "name": "Better Theatricals", + "pattern": "^\\b(terminator.?2|alien[^s].*?1979|star.wars.*?(4k|19)(77)|.*?\\bempire.strikes.back|.*?\\breturn.of.the.jedi|apocalypse.now|the.exorcist.*?1973|donnie.darko|amadeus|payback.*?1999|payback.straight.up.*?2006|almost.famous)\\b", + "description": "Matches movies where the `Theatrical` cut is considered the better version. Subjectively chosen, based on Dictionarry's personal preferences and major opinion. Needed to override the default special edition preference. Matches:\n- Terminator 2: Judgement Day (1991)\n- Alien (1979)\n- Star Wars OT (1977-1983)\n- Apocalypse Now (1979)\n- The Exorcist (1973)\n- Donnie Darko (2001)\n- Amadeus (1984)\n- Payback (1999)\n- Almost Famous (2000)", + "tags": [ + "Edition" + ], + "tests": [ + { + "expected": true, + "id": 1, + "input": "Terminator.2.Judgment.Day.Theatrical.Cut.1991.1080p.BluRay.DTS.x264.D-Z0N3", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 12, + "start": 0 + }, + "matchedContent": "Terminator.2", + "matchedGroups": [ + "Terminator.2", + null, + null + ], + "passes": true + }, + { + "expected": false, + "id": 2, + "input": " Aliens.1986.Special.Edition.1080p.BluRay.DTS.x264-Geek.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": null, + "matchedContent": null, + "matchedGroups": [], + "passes": true + }, + { + "expected": true, + "id": 3, + "input": "Alien.1979.Directors.Cut.2in1.BluRay.1080p.AVC.DTS-HD.MA5.1-CHDBits", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 10, + "start": 0 + }, + "matchedContent": "Alien.1979", + "matchedGroups": [ + "Alien.1979", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 4, + "input": "star.wars.4K77.2160p.UHD.No-DNR.35mm.x265-v1.4.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 14, + "start": 0 + }, + "matchedContent": "star.wars.4K77", + "matchedGroups": [ + "star.wars.4K77", + "4K", + "77" + ], + "passes": true + }, + { + "expected": true, + "id": 5, + "input": "Star.Wars.Episode.IV.A.New.Hope.1977.COMPLETE.UHD.BLURAY-DIZZKNEE", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 36, + "start": 0 + }, + "matchedContent": "Star.Wars.Episode.IV.A.New.Hope.1977", + "matchedGroups": [ + "Star.Wars.Episode.IV.A.New.Hope.1977", + "19", + "77" + ], + "passes": true + }, + { + "expected": true, + "id": 6, + "input": "Star.Wars.1977.Theatrical.Cut.DVDRip.AC3.x264.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 14, + "start": 0 + }, + "matchedContent": "Star.Wars.1977", + "matchedGroups": [ + "Star.Wars.1977", + "19", + "77" + ], + "passes": true + }, + { + "expected": true, + "id": 7, + "input": "03 Empire.Strikes.Back.4K80.2160p.UHD.no-DNR.35mm.x265-v1.0.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 22, + "start": 0 + }, + "matchedContent": "03 Empire.Strikes.Back", + "matchedGroups": [ + "03 Empire.Strikes.Back", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 8, + "input": "Star.Wars.Episode.V.The.Empire.Strikes.Back.1980.2160p.UHD.BluRay.Remux.HDR.HEVC.Atmos-PmP.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 43, + "start": 0 + }, + "matchedContent": "Star.Wars.Episode.V.The.Empire.Strikes.Back", + "matchedGroups": [ + "Star.Wars.Episode.V.The.Empire.Strikes.Back", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 9, + "input": "Empire.Strikes.Back.1980.35mm.Renegade.Grindhouse.Scan.480p.DD2.0.x264.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 19, + "start": 0 + }, + "matchedContent": "Empire.Strikes.Back", + "matchedGroups": [ + "Empire.Strikes.Back", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 10, + "input": "Return.of.the.Jedi.4K83.2160p.UHD.35mm.x265-v1.1.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 18, + "start": 0 + }, + "matchedContent": "Return.of.the.Jedi", + "matchedGroups": [ + "Return.of.the.Jedi", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 11, + "input": "Star Wars Episode VI - Return of the Jedi (1983) 2160p UHD BluRay TrueHD 7.1 HDR x265-Chotab.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 41, + "start": 0 + }, + "matchedContent": "Star Wars Episode VI - Return of the Jedi", + "matchedGroups": [ + "Star Wars Episode VI - Return of the Jedi", + null, + null + ], + "passes": true + }, + { + "expected": false, + "id": 12, + "input": "Star.Wars.Episode.IX.The.Rise.of.Skywalker.2019.UHD.BluRay.2160p.TrueHD.Atmos.7.1.HEVC.REMUX-FraMeSToR.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": null, + "matchedContent": null, + "matchedGroups": [], + "passes": true + }, + { + "expected": true, + "id": 13, + "input": "Apocalypse.Now.1979.Final.Cut.UHD.BluRay.2160p.TrueHD.Atmos.7.1.DV.HEVC.HYBRID.REMUX-FraMeSToR.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 14, + "start": 0 + }, + "matchedContent": "Apocalypse.Now", + "matchedGroups": [ + "Apocalypse.Now", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 14, + "input": "The.Exorcist.1973.2160p.UHD.Blu-ray.Remux.HDR.HEVC.TrueHD.7.1.Atmos-CiNEPHiLES.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 17, + "start": 0 + }, + "matchedContent": "The.Exorcist.1973", + "matchedGroups": [ + "The.Exorcist.1973", + null, + null + ], + "passes": true + }, + { + "expected": false, + "id": 15, + "input": "The Pope's Exorcist 2023 1080p WEBRip DD+5.1 x264-HiDt.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": null, + "matchedContent": null, + "matchedGroups": [], + "passes": true + }, + { + "expected": false, + "id": 16, + "input": "The Exorcist III 1990 Theatrical 1080p BluRay DTS x264-VietHD.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": null, + "matchedContent": null, + "matchedGroups": [], + "passes": true + }, + { + "expected": true, + "id": 17, + "input": "Donnie.Darko.2001.2160p.UHD.Blu-ray.Remux.HEVC.HDR.DoVi.DTS-HD.MA.5.1-ARROW4KDV.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 12, + "start": 0 + }, + "matchedContent": "Donnie.Darko", + "matchedGroups": [ + "Donnie.Darko", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 18, + "input": "Amadeus.1984.Blu-Ray.1080p.DTSHD-MA.VC-1.Remux-HiFi.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 7, + "start": 0 + }, + "matchedContent": "Amadeus", + "matchedGroups": [ + "Amadeus", + null, + null + ], + "passes": true + }, + { + "expected": false, + "id": 19, + "input": "National Theatre Live- Amadeus (2017).mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": null, + "matchedContent": null, + "matchedGroups": [], + "passes": true + }, + { + "expected": true, + "id": 20, + "input": "Payback.Straight.Up.Directors.Cut.1999.Bluray-PTP", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 38, + "start": 0 + }, + "matchedContent": "Payback.Straight.Up.Directors.Cut.1999", + "matchedGroups": [ + "Payback.Straight.Up.Directors.Cut.1999", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 21, + "input": "Payback.1999.Theatrical.Cut.BluRay.1080p.TrueHD.5.1.VC-1.REMUX-FraMeSToR.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 12, + "start": 0 + }, + "matchedContent": "Payback.1999", + "matchedGroups": [ + "Payback.1999", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 22, + "input": "Payback Straight Up 2006 DC 1080p HDDVD DD5.1 x264-RightSiZE.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 24, + "start": 0 + }, + "matchedContent": "Payback Straight Up 2006", + "matchedGroups": [ + "Payback Straight Up 2006", + null, + null + ], + "passes": true + }, + { + "expected": true, + "id": 23, + "input": "Payback.Theatrical.Cut.1999.1080p.BluRay.DD5.1.x264-REPTiLE.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 27, + "start": 0 + }, + "matchedContent": "Payback.Theatrical.Cut.1999", + "matchedGroups": [ + "Payback.Theatrical.Cut.1999", + null, + null + ], + "passes": true + }, + { + "expected": false, + "id": 24, + "input": " Payback.2021.1080p.WEB.h264-RUMOUR.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": null, + "matchedContent": null, + "matchedGroups": [], + "passes": true + }, + { + "expected": false, + "id": 25, + "input": "Payback.DVDRip.AVC.AC3.(1995).mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": null, + "matchedContent": null, + "matchedGroups": [], + "passes": true + }, + { + "expected": true, + "id": 26, + "input": "Almost.Famous.2000.Bootleg.Cut.UHD.BluRay.2160p.DTS-HD.MA.5.1.DV.HEVC.HYBRID.REMUX-FraMeSToR.mkv", + "lastRun": "2025-02-24T21:16:01.912349", + "matchSpan": { + "end": 13, + "start": 0 + }, + "matchedContent": "Almost.Famous", + "matchedGroups": [ + "Almost.Famous", + null, + null + ], + "passes": true + } + ], + "_id": "Better Theatricals" + }, { "name": "BeyondHD", "pattern": "(?<=^|[\\s.-])BeyondHD\\b", @@ -1946,6 +2350,48 @@ "tests": [], "_id": "EbP" }, + { + "name": "Extended Clip", + "pattern": "\\b(extended.?clip)\\b", + "description": "Matches preview releases labelled as `Extended Clip`", + "tags": [ + "Preview", + "Unwanted" + ], + "tests": [ + { + "expected": true, + "id": 1, + "input": "Killers Of The Flower Moon 2023 Extended Clip 1080p AMZN WEB-DL DDP 5.1 H 264-FLUX", + "lastRun": "2025-02-25T22:09:00.135768", + "matchSpan": { + "end": 45, + "start": 32 + }, + "matchedContent": "Extended Clip", + "matchedGroups": [ + "Extended Clip" + ], + "passes": true + }, + { + "expected": true, + "id": 2, + "input": "Killers.of.The.Flower.Moon.2023.Extended.Clip.1080p.AMZN.WEB-DL.DDP5.1.H.264-FLUX", + "lastRun": "2025-02-25T22:09:00.135768", + "matchSpan": { + "end": 45, + "start": 32 + }, + "matchedContent": "Extended.Clip", + "matchedGroups": [ + "Extended.Clip" + ], + "passes": true + } + ], + "_id": "Extended Clip" + }, { "name": "Extras", "pattern": "(?i)(?<=\\b[12]\\d{3}\\b).*(\\b|\\.)\\b(Extras?|Bonus|Extended[ ._-]Clip|Special Feature[s]?)\\b", @@ -3071,6 +3517,158 @@ "tests": [], "_id": "IDE" }, + { + "name": "IMAX Enhanced", + "pattern": "^(?=.*\\b((DSNP|Disney\\+|BC|B?CORE)(?=.?web.?(dl|rip)\\b)))(?=.*\\b((?
- It rewards efficient encodes regardless of codec choice
- It catches inefficient HEVC encodes that waste space
- It avoids the complexity of parsing inconsistent HEVC labeling (h265/x265)
- It future-proofs the system for newer codecs like AV1, where we can simply adjust our codec ranking priorities (AV1 > HEVC > AVC) while still maintaining the core efficiency metric

Think of it this way: users don't actually care what codec is used - they care about getting high quality video at reasonable file sizes. Our metric measures this directly instead of using codec choice as an unreliable proxy. |\n| But doesn't this ignore quality? | The current encoding landscape places tremendous emphasis on maximizing absolute quality, often treating file size as a secondary concern. This metric aims to challenge that, or at least find a middle ground - we care about quality (hence why we use proper sources as our baseline and consider VMAF scores), but we acknowledge that most users only care about getting file sizes they actually want, and not the marginal quality improvements you get from encoding from a remux, compared to a web-dl. Rather than taking either extreme position - \"quality above all\" or \"smaller is always better\" - we focus on _efficiency_: getting the best practical quality for any given file size target. This approach **will not** satisfy quality enthusiasts, but it better serves the needs of most users. |\n| What if the source is not a 1080p remux? How do you tell? | This metric, like any data-driven system, will never achieve 100% accuracy. However, we can parse various indicators beyond just the release group or streaming service to identify non-remux sources. For example, we can identify when a non-DS4K WEB-DL or non-webrip from a reputable group is likely sourced from another lossy encode rather than a remux. We also maintain a manual tagging system to downrank certain release groups known for reencoding from non-high-quality sources. Groups like PSA and MeGusta will be ranked lower in the system, regardless of their efficiency scores, due to their known practices. |\n| How do you prefer HEVC? | We actually approach this from the opposite direction - instead of preferring HEVC, we downrank AVC. This is because HEVC naming conventions are inconsistent (groups use x265 and h265 interchangeably), making them difficult to parse reliably. In contrast, AVC is almost always labeled consistently as either x264 or h264, making it much easier to identify and downrank these releases. |\n| Why not consider releases above 40% efficiency? | For standard 1080p non-HDR content, above 40% compression ratio, x264 and x265 perform nearly identically in terms of VMAF scores, eliminating HEVC's key advantages. At this point, x264 becomes the preferred choice across all metrics - the encodes are easier to produce, far more common, and typically undergo more rigorous quality control. There's simply no compelling reason to use HEVC at these higher bitrates for standard 1080p content. |\n| What about animated content? | Animated content typically has different compression characteristics than live action - it often achieves excellent quality at much lower bitrates due to its unique properties (flat colors, sharp edges, less grain). Ideally, we would use higher target ratios for live action and lower ones for animation. However, reliably detecting animated content programmatically is extremely challenging. While we can sometimes identify anime by certain keywords or release group patterns, western animation, partial animation, and CGI-heavy content create too many edge cases for reliable detection. For now, we treat all content with the same metric, acknowledging this as a known limitation of the system. Users seeking optimal results for animated content may want to target lower compression ratios than they would for live action material, perhaps via a duplicate profile at a different compression target. |\n| Why does transparency require 60% at 2160p compared to 40% at 1080p? | The higher ratio requirement for 2160p content stems from several technical factors that compound to demand more data for achieving transparency:

1. **Increased Color Depth**: Most 2160p content uses 10-bit color depth compared to 8-bit for standard 1080p content. This 25% increase in bit depth requires more data to maintain precision in color gradients and prevent banding.

2. **HDR Requirements**: 2160p content often includes HDR metadata, which demands more precise encoding of brightness levels and color information. The expanded dynamic range means we need to preserve more subtle variations in both very bright and very dark scenes.

3. **Resolution Scaling**: While 2160p has 4x the pixels of 1080p, compression efficiency doesn't scale linearly. Higher resolution reveals more subtle details and film grain, which require more data to preserve accurately.

These factors combine multiplicatively rather than additively, which is why we need a 50% increase in the compression ratio ceiling (from 40% to 60%) to achieve similar perceptual transparency. |\n| Do all 2160p releases need 60% for transparency? | No, the actual requirements vary significantly based on several factors:

1. **Content Type**:
- Animation might achieve transparency at 30-40%
- Digital source material (like CGI-heavy films) often requires less
- Film-based content with heavy grain needs the full 60%

2. **HDR Implementation**:
- SDR 2160p content can often achieve transparency at lower ratios
- Dolby Vision adds additional overhead compared to HDR10
- Some HDR grades are more demanding than others

3. **Source Quality**:
- Digital intermediate resolution (2K vs 4K)
- Film scan quality and grain structure
- Original master's bit depth and color space

4. **Scene Complexity**:
- High motion scenes need more data
- Complex textures and patterns require higher bitrates
- Dark scenes with subtle gradients are particularly demanding |\n\n[^1]: Shen, Y. (2020). \"Bjontegaard Delta Rate Metric\". Medium Innovation Labs Blog. https://medium.com/innovation-labs-blog/bjontegaard-delta-rate-metric-c8c82c1bc42c\n[^2]: Ling, N.; Antier, M.; Liu, Y.; Yang, X.; Li, Z. (2024). \"Video Quality Assessment: From FR to NR\". Electronics, 13(5), 953. https://www.mdpi.com/2079-9292/13/5/953", - "last_modified": "2025-02-26T06:03:23.018624+00:00", + "last_modified": "2025-02-26T06:11:17.516985+00:00", "title": "Encode Efficiency Index", "slug": "EEi", "author": "santiagosayshey", @@ -17,7 +17,7 @@ { "_id": "FAQ", "content": "This entry is dedicated to providing answers to the most frequently asked questions about Dictionarry / Profilarr.\n\n| Question | Answer |\n| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Why isn't the highest scored release being grabbed? | You may have prefer propers and repacks on. This option forces releases with a proper / repack flag to be grabbed, even if it's Custom Format score is not the highest. To turn it off, navigate to Settings > Media Management > File Management and set Prefer Propers / Repacks to Do Not Prefer. |\n| What's the difference between h264, x264, AVC, h265, x265 and HEVC? | **H.264 (AVC)**: A video compression standard.
**x264**: An open source encoder that produces H.264 videos.
**H.265 (HEVC)**: A more advanced video compression standard than H.264, offering better compression and quality for 4K and higher resolutions.
**x265**: An open source encoder that produces H.265 videos.

**Key Points**:
- HEVC/AVC refers to the codec in general
- H.264/5 refers to a lossless rip (WEB-DL or remux)
- x264/5 refers to encoded content (WEBRip or Blu-ray encode)

_Note: Many HEVC files are mislabeled, making it challenging to distinguish between lossless and lossy releases based on release names alone._ |\n| What quality settings should I use? | It's suggested that you should set everything to min / max since Profilarr uses custom formats to do the major selections. However you might run into the occasional sample download if you use lots of usenet indexers. If you do find that these are being grabbed, then you can set the minimum to be 1-2gb per hour for whatever quality you need it in. |\n| What does \"Transparency\" mean? | Audiovisual transparency refers to the degree to which an encoded audio or video signal is indistinguishable from the original source signal. The term \"transparency\" stems from the idea that the encoding and decoding processes are imperceptible, as if the system were _transparent_.

- An audio codec with high transparency will produce an encoded signal that, when decoded, is identical to the original audio source, without any discernible differences in frequency response, dynamic range, or noise floor.

- A video codec exhibiting transparency will generate an encoded signal that, upon decoding, results in a picture that is visually indistinguishable from the source video in terms of resolution, color space, and pixel-level detail.

Objective metrics, such as [VMAF (Video Multi-Method Assessment Fusion)](https://en.wikipedia.org/wiki/Video_Multimethod_Assessment_Fusion), are sometimes used to measure transparency by comparing the encoded signal to the original source and calculating a numerical score that quantifies the perceptual similarity between the two, with higher scores indicating greater transparency. |", - "last_modified": "2025-02-26T06:03:23.019624+00:00", + "last_modified": "2025-02-26T06:11:17.516985+00:00", "title": "FAQ", "slug": "faq", "author": "santiagosayshey", @@ -31,7 +31,7 @@ { "_id": "GPPi", "content": "## What are Golden Popcorns?\n\n**_Golden Popcorns_** are _very high quality encodes_, marked as such by one of the best private torrent trackers. These releases are manually reviewed by a dedicated, experienced team of _Golden Popcorn_ checkers. Golden Popcorns are the simplest way to quantify a subjective _best_ encode.\n\n## The Decision Engine\n\nThe Golden Popcorn Performance Index, or GPPI, is a calculated metric, pivotal to the [Transparent](../Profiles/1080p%20Transparent.md) profile's decision-making process. It's engineered to rank release groups based on their propensity to release a Golden Popcorn encode at any given resolution $r$.\n\n## Formula\n\nOn first glance, it seems the most obvious way to determine which release groups are most likely to release golden popcorns is to find their Golden Popcorn Ratio, i.e. The number of Golden Popcorns divided by the total number of encodes for any given resolution _r_.\n\nHowever, If we were to take Golden Popcorn ratio at face value, we might incorrectly prioritise a release group who has a high GP ratio, but a low number of encodes. On the opposite spectrum, if we take the raw number of Golden Popcorns for any group, we might incorrectly prioritise a group with a low GP ratio.\n\nSo instead, we multiply the number of Golden Popcorns at resolution $r$ for a given release group, by a factor of said release group's Golden Popcorn Ratio. This essentially limits both metrics as a factor of each other.\n\nFor any given resolution _r_, the GPPI is defined as:\n\n$$\n\\begin{aligned}\n\\text{GPPI}_r &= GPE_r \\cdot \\left( \\frac{GPE_r}{E_r} \\right) \\\\\n &= \\frac{GPE_r^2}{E_r}\n\\end{aligned}\n$$\n\nWhere:\n\n- $\\text{GPPI}_r$ is the Golden Popcorn Performance Index at resolution $r$\n- $GPE_r$ is the number of Golden Popcorns at resolution $r$\n- $E_r$ is the total number of encodes at resolution $r$", - "last_modified": "2025-02-26T06:03:23.019624+00:00", + "last_modified": "2025-02-26T06:11:17.516985+00:00", "title": "Golden Popcorn Performance Index", "slug": "GPPi", "author": "santiagosayshey", @@ -46,7 +46,7 @@ { "_id": "RGP", "content": "## So, how does Dictionarry _actually simplify media automation?_\n\nWell, first we need to understand that we're trying to **automate the subjective analysis of how \"good\" a release is**. To do that, we need to first define **what \"good\" even means**. To some people, it could mean how well something looks on their screen, or sounds through speakers; we define this as _quality_. To others, it means how many releases they can download while still maintaining some kind of quality standard; we define this as _efficiency_.\n\nSo, that leads us to a new question - _how do we measure quality and efficiency_? You might think we'd want to parse releases and find their technical properties; resolution, bitrate, video / audio codecs, hdr, etc.\n\n```\nRelease 1 (25.2 GiB): Blockbuster Movie A 2022 Hybrid 1080p WEBRip DDPA5.1 x264-group A\n\nRelease 2 (27.3 GiB): Blockbuster Movie A.1080p.WEBRip.DD+7.1.x264-group B\n```\n\nLooking at these two releases, you'll notice that they both have the EXACT same technical specification and would rank equally. But they're different sizes... so which is better? Using audio / video properties to measure quality / efficiency can be effective, but is largely **limited by the information that they convey**. You can't adequately answer which is better just by looking at these releases in isolation. So how do we not look at these releases in isolation? Or rather, how do we _extrapolate information that isn't already there?_\n\n### Group Tags\n\nOur answer lies in the little bit of information at the end of every release - it's **group tag**. Dictionarry tracks historic release group data in order to **rank groups based on their propensity to reach quantifiable levels of quality and efficiency**. We do this using two metrics:\n\n1. Golden Popcorn Performance Index (GPPi): How many golden popcorns a release group has, as a ratio of their total number of releases\n2. Encode Efficiency Index (EEi): The average size of a release group's encode compared to it's likely source.\n\nThese metrics are **evidence based, data driven and objective**.\n\n### TL;DR\n\nTL;DR: Dictionarry **simplifies media automation by prioritizing release groups that achieve quantifiable levels of quality and efficiency through objective measurement**. These release group rankings are built and maintained as custom formats to be scored in their respective quality profiles. You can review these group rankings below.", - "last_modified": "2025-02-26T06:03:23.019624+00:00", + "last_modified": "2025-02-26T06:11:17.516985+00:00", "title": "Release Group Philosophy", "slug": "RGP", "author": "santiagosayshey", @@ -62,7 +62,7 @@ { "_id": "edition", "content": "By default, Dictionarry's profiles prefer the ['Special' Edition](https://dictionarry.dev/formats/special-edition) of each movie. This is because these editions are often considered the more 'definitive' version of the movie because they contain the director's complete creative vision without studio interference or runtime constraints, and are often recommended over their theatrical counterparts.\n\n| Movie | Preferred Version | Reasons |\n| ----------------------------------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Aliens (1986) | Special | James Cameron's Special Edition enhances the film with crucial character development, particularly the scenes about Ripley's daughter which add emotional depth to her relationship with Newt. While the theatrical cut has tighter pacing, the added content like the sentry gun sequences adds valuable world-building and tension. The colony scenes provide important context that enriches rather than spoils the story. |\n| Blade Runner (1982) | Final Cut | The Final Cut (2007) is considered the definitive version over theatrical, workprint, and Director's Cut releases. It removes the theatrical's controversial voice-over narration and \"happy ending\" that were studio-mandated and disliked by cast and crew. It preserves the original's ambiguous ending about Deckard's nature while fixing numerous continuity errors and technical issues. Key improvements include: cleaned up wire removal in spinner scenes, fixed lip sync in Zhora's death scene, digital correction of the obvious stunt double's face, properly matching the number of replicants mentioned to those shown, correction of the dove release scene's obvious day-for-night shooting, improved color timing that better matches Jordan Cronenweth's original cinematography, and restoration of the full unicorn dream sequence that better supports the film's central mysteries. While some defend elements of other versions (particularly the 1992 Director's Cut), the Final Cut represents Ridley Scott's complete creative vision with modern technical capabilities to properly realize it. |\n| The Lord of the Rings Trilogy (2001-2003) | Extended Editions | Each film's Extended Edition adds crucial character development, world-building and plot points that enrich the story: Fellowship adds the gift-giving scene and more Lothlorien. Two Towers expands Boromir/Faramir's backstory, adds Theodred's funeral for deeper Rohan culture. Return of the King adds the Witch King destroying Gandalf's staff, Saruman's fate, and House of Healing. The additional 30-50 minutes per film are so seamlessly integrated that many fans consider these the definitive versions. |\n| Batman v Superman: Dawn of Justice (2016) | Ultimate Edition | The 3-hour cut restores crucial plot threads that explain character motivations and fill plot holes. Added scenes show Superman actually helping people, Lex's manipulation of both heroes, and clearer reasons for the African incident blamed on Superman. The extended cut makes the story more coherent while better developing both protagonists' perspectives. |\n| The Abyss (1989) | Special Edition | The extended version restores a crucial tidal wave sequence that better explains the aliens' motivations and adds a stronger environmental message to the ending. Additional scenes provide more context for the NTIs (non-terrestrial intelligence) and their purpose, while expanding character relationships. Most notably, the restored ending gives the film a more impactful and complete conclusion that Cameron originally intended. |\n| Midsommar (2019) | Director's Cut | The 171-minute version adds key scenes that provide deeper insight into the relationship dynamics, particularly Christian's gaslighting of Dani. Additional folk-horror rituals and customs make the H\u00e5rga community feel more developed and their practices more grounded. The added character moments make the emotional climax more impactful. |\n| I Am Legend (2007) | Alternate Version | This version's different ending completely changes the meaning of the title and stays truer to Richard Matheson's novel. Instead of Smith's character killing himself to stop the creatures, he realizes they are actually intelligent beings protecting their own, making him the monster of their legends - their \"legend.\" This ending better serves the film's themes about humanity and perspective. |\n| Watchmen (2009) | Director's Cut | The 186-minute version adds essential character depth and crucial plot elements from the graphic novel, including more of Hollis Mason and his death scene. The extended cut better develops the complexity of the alternate 1985 setting and the moral ambiguity of its characters. The Ultimate Cut, which adds the Tales of the Black Freighter animation, is considered by some fans to be even more complete, though the Director's Cut is the most widely preferred version. |\n| Superman II (1980/2006) | The Richard Donner Cut | Released 26 years after the theatrical version, Donner's cut restores his original vision before he was replaced by Richard Lester. It removes the slapstick comedy, restores Marlon Brando's scenes as Jor-El, and features a different ending that ties better to the first film. The more serious tone and stronger character development make it the preferred version for most fans. |\n\nHowever, while special editions often expand and enrich films, theatrical versions have their own merits that many cinephiles and critics prefer. Theatrical cuts typically offer tighter pacing, maintain the mystery of intentional ambiguity, and preserve the historical significance of films as they were originally experienced by audiences. Here's why some prefer theatrical versions:\n\n| Movie | Preferred Version | Key Reasons |\n| --------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Terminator 2: Judgment Day (1991) | Theatrical | The theatrical cut is nearly perfect in pacing and storytelling. The extended cut's additional scenes (like T-1000 glitching after freezing, John reprogramming the T-800) are interesting but unnecessary. The theatrical version maintains better tension and momentum. Most notably, the \"happy ending\" playground scene in the theatrical cut is preferred to the extended cut's darker alternate ending. |\n| Alien (1979) | Theatrical | The theatrical version is considered a masterpiece of pacing. The Director's Cut adds scenes that, while interesting (like Ripley finding Dallas in the cocoon), actually harm the rapid-fire tension of the final act. Scott himself has stated he prefers the theatrical cut. |\n| Star Wars (1977) | Theatrical | The original theatrical cut is considered more pure and less cluttered than later \"Special Editions\". Fans particularly dislike added CGI elements and the infamous \"Han shot first\" change. The pacing of the theatrical cut is also tighter. |\n| The Empire Strikes Back (1980) | Theatrical | Like A New Hope, fans strongly prefer the unaltered theatrical version. The Special Edition's added CGI and altered effects (like the Emperor hologram replacement, added windows in Cloud City) are considered unnecessary changes to a perfect film. The original practical effects and cinematography are considered superior. |\n| Return of the Jedi (1983) | Theatrical | The theatrical version is preferred over the Special Edition's controversial additions, particularly the changed ending music and added CGI celebration scenes. The \"Jedi Rocks\" musical number in Jabba's Palace is one of the most criticized Special Edition changes. The original Ewok celebration song \"Yub Nub\" is often preferred to the new ending. |\n| Apocalypse Now (1979) | Theatrical | While Redux (2001) and the Final Cut add interesting material, many feel the additions (especially the French plantation sequence) harm the pacing and dilute the core narrative. The theatrical cut maintains better tension and forward momentum. |\n| The Exorcist (1973) | Theatrical | \"The Version You've Never Seen\" adds the famous \"spider walk\" scene and several other moments, but the theatrical cut's pacing is superior. The original version better maintains its sense of building dread. |\n| Donnie Darko (2001) | Theatrical | The Director's Cut over-explains the film's mythology through added scenes and graphics, removing much of the mystery that made the original so compelling. The theatrical cut's ambiguity encourages viewer interpretation. |\n| Amadeus (1984) | Theatrical | The theatrical cut maintains better pacing and tighter focus on the central Salieri-Mozart conflict. Director's Cut adds 20 minutes of historical context and servant relationships that, while interesting, don't enhance the core psychological drama. The theatrical version better preserves the opera-like structure of the narrative. |\n| Payback (1999) | Theatrical | The theatrical version's blue-tinted color scheme better fits the neo-noir tone. The original ending with Kris Kristofferson provides a more satisfying conclusion than the Director's Cut (\"Straight Up\" version\"). Mel Gibson's voice-over is more engaging, and the slightly lighter tone makes Porter more sympathetic while maintaining the film's edge. Despite extensive studio interference, the theatrical cut became more commercially and critically successful. |\n| Almost Famous (2000) | Theatrical | While the \"Untitled: The Bootleg Cut\" adds interesting character moments and music scenes, the theatrical cut's tighter 122-minute runtime provides better pacing and more focused storytelling. Cameron Crowe's theatrical version better captures the whirlwind feeling of being on tour, while the 40 extra minutes in the extended cut, though enjoyable for fans, can make the journey feel too leisurely. |\n\nA [Custom Format: Special Edition (Unwanted)]() has been created to negate special editions for these specific movies, but does not yet work due to radarr/sonarr's parsing of release titles. The parsed 'Title' is removed from the release title, so you can't actually identify movies from custom formats (yet). Once this becomes possible, a single profile will be able to selectively prefer theatrical releases over special ones.\n\nTo mimic this behaviour in the current system, you have to copy the profile you want to use and set it's `Special Edition` score to the negative of whatever it was. Then apply the profile to whatever movie you want in it's theatrical version.", - "last_modified": "2025-02-26T06:03:23.019624+00:00", + "last_modified": "2025-02-26T06:11:17.516985+00:00", "title": "Edition Philosophy", "slug": "edtion-philosophy", "author": "santiagosayshey", @@ -77,7 +77,7 @@ { "_id": "home", "content": "# \ud83d\udc4b Hey!\n\nWelcome to Dictionarry! This project aims to wiki-fy and **simplify media automation** in Radarr / Sonarr through extensive, data driven documentation, custom formats and quality profiles.\n\n---\n\n## \ud83d\udca1 Motivation\n\nNavigating the world of media automation and coming across quality terms like \"Remux\", or \"HEVC\" or \"Dolby Vision\" can be quite daunting when all you want to do is setup a media server to watch some content. It often **feels like you need a masters in audio / video just to grab the latest blockbuster.** Dictionarry aims not to explain these concepts in detail, but **abstract them into more approachable ideas** that don't require extensive knowledge or experience.\n\nDictionarry leverages two key features of Radarr and Sonarr to simplify media automation:\n\n1. Custom Formats - Think of these as smart filters that scan release titles for specific patterns. They help **identify important characteristics** of your media, such as:\n\n - Video quality (4K, HDR, Dolby Vision)\n - Audio formats (Atmos, DTS, TrueHD)\n - Source types (Remux, Web-DL, Blu-ray)\n - Potential issues (upscaled content, poor encodes)\n\n2. Quality Profiles - These act like a scoring system that **ranks releases** based on their Custom Format matches. You can:\n - Prioritize what matters most to you\n - Automatically upgrade to better versions\n - Avoid problematic releases\n\nThink of Dictionarry as your personal car-buying expert: Instead of researching every technical specification and test-driving dozens of vehicles, you get access to a curated showroom of pre-vetted options that match what you're looking for. Whether you want:\n\n- 2160p Remux - **Maximum Quality** 4K HDR remuxes with lossless audio and Dolby Vision\n- 2160p Quality - **Transparent 4K** HDR encodes selected using the Encode Efficiency Index\n- 1080p Quality - **Transparent 1080p** encodes optimized using the Golden Popcorn Performance Index\n- 1080p Efficient - **Efficient x265 1080p** Encodes optimized to save space using the Encode Efficiency Index\n\n![Profile Preview](https://i.imgur.com/nZQzN9I.png)\n\nDictionarry's database of tested profiles and formats handles the technical decisions for you.\n\n---\n\n## \u2699\ufe0f Profilarr\n\nThe database by itself does nothing. Custom Formats and Quality Profiles **need to be imported** and configured in your individual arr installations. Rather than leaving you to manually create everything yourself based on our guides, we've created **Profilarr** to automate this process.\n\nProfilarr is a **configuration management tool** for Radarr and Sonarr that can interface with **ANY remote configuration database** (not just Dictionarry's!). It automatically:\n\n- **Pulls** new updates from your chosen database\n- **Compiles** the database format into specific arr formats\n- **Imports** them to your arr installations\n- Manages version control of your configurations\n\nBuilt on top of git, Profilarr treats your configurations like code, allowing you to:\n\n- Track changes over time\n- Maintain your own customizations while still receiving database updates\n- Resolve conflicts between local / remote changes when they arise\n\nThe architecture was specifically built like this to **put user choice first**. We believe that:\n\n- **Your media setup should reflect your needs, not our opinions**\n- Updates should enhance your configuration, not override it\n- Different users have different requirements (storage constraints, hardware capabilities, quality preferences)\n- The ability to customize should never be sacrificed for convenience\n\nProfilarr empowers you to use Dictionarry's database (or anyone elses!) as a foundation while maintaining the freedom to adapt it to your specific needs.\n\n## \ud83d\udd28 Development Notice\n\nCustom Formats / Quality profiles on this site reflect the contents of the [Dictionarry Database](https://github.com/Dictionarry-Hub/database) and what the upcoming Profilarr GUI will clone / import. The old profilarr scripts still use outdated profiles / custom formats! We're currently in a bit of an inbetween state at the moment, so please bare with us as we get the new Profilarr version out!", - "last_modified": "2025-02-26T06:03:23.019624+00:00", + "last_modified": "2025-02-26T06:11:17.516985+00:00", "title": "home", "slug": "home", "author": "santiagosayshey",