flan/jellyfin-audience
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Apply the community-rating floor to rated titles as well

Browse Source 
The audience tag admitted any title whose official rating sat at or below the
ceiling, with no quality condition at all. The community-rating floor was only
consulted when a title had no usable rating. On a real library that let 21
poorly reviewed but mildly rated titles through - Norbit, Cats, Super Mario
Bros., Rocky V, Cool as Ice among them - none of which belong in a library whose
entire purpose is to be smaller than the one it was carved out of. A ceiling
answers whether a title is suitable; it says nothing about whether it is worth
offering.

MinCommunityRating now applies to rated titles, alongside the existing
MinCommunityRatingWhenUnrated for titles with no rating to judge. The two are
separate settings because an unrated title carries more uncertainty and may
warrant a higher bar. A rated title with no community rating at all now fails,
which is deliberate: with neither a score to check nor a reputation to weigh,
there is nothing to decide on.

Verified against the live library: a full pass over 2778 titles settles at 561
tagged, and the 21 are not re-added.
This commit is contained in:
flan
2026-09-19 23:35:13 +00:00
parent 997c257442
commit 6334f3f4da
4 changed files with 43 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Jellyfin.Plugin.Audience/AudienceRules.cs
+12 -5
View File
@@ -130,15 +130,22 @@ public static class AudienceRules
return false;
}
// A usable rating is judged on the rating. Anything at or below the ceiling is in.
// A usable rating must clear the ceiling AND the quality floor. The floor matters
// as much as the ceiling: the point of this tag is to make an overwhelming library
// smaller, and a poorly reviewed film that happens to be rated PG adds noise rather
// than removing it. An item with no community rating at all fails here, which is
// deliberate - without a rating and without a score there is nothing to judge on.
if (ratingScore.HasValue)
{
return ratingScore.Value <= config.MaxRatingScore;
return ratingScore.Value <= config.MaxRatingScore
&& item.CommunityRating.HasValue
&& item.CommunityRating.Value >= config.MinCommunityRating;
}
// No usable rating: fall back to reputation. This is what keeps the older
// classics, which are exactly what this audience wants and which TMDB
// frequently has no US certification for.
// No usable rating: fall back to reputation alone, against its own floor. This is
// what keeps the older classics, which are exactly what this audience wants and
// which TMDB frequently has no US certification for. The floor is separate because
// an unrated item is carrying more risk, so it may warrant a higher bar.
return item.CommunityRating.HasValue
&& item.CommunityRating.Value >= config.MinCommunityRatingWhenUnrated;
}
Jellyfin.Plugin.Audience/Configuration/PluginConfiguration.cs
+9
View File
@@ -51,6 +51,15 @@ public class PluginConfiguration : BasePluginConfiguration
/// </remarks>
public int MaxRatingScore { get; set; } = 14;
/// <summary>
/// Gets or sets the community rating an item must reach to be tagged when it DOES have a
/// usable official rating. The ceiling alone is not enough: this tag exists to make an
/// overwhelming library smaller, and a poorly reviewed film that happens to be rated PG
/// adds noise rather than removing it. An item carrying no community rating at all fails
/// this check, which is deliberate.
/// </summary>
public double MinCommunityRating { get; set; } = 6.0;
/// <summary>
/// Gets or sets the minimum community rating for an item with no usable parental rating.
/// </summary>
Jellyfin.Plugin.Audience/Configuration/configPage.html
+13
View File
@@ -84,6 +84,17 @@
</div>
</div>
<div class="inputContainer">
<label class="inputLabel inputLabelUnfocused" for="MinCommunityRating">Community rating floor for rated items</label>
<input is="emby-input" type="number" id="MinCommunityRating" min="0" max="10" step="0.1" />
<div class="fieldDescription">
A rated item must clear this as well as the ceiling. The point of the tag
is to make an overwhelming library smaller, and a poorly reviewed film
that happens to be rated PG adds noise rather than removing it. An item
with no community rating at all fails this check.
</div>
</div>
<div class="inputContainer">
<label class="inputLabel inputLabelUnfocused" for="MinCommunityRatingWhenUnrated">Community rating floor for unrated items</label>
<input is="emby-input" type="number" id="MinCommunityRatingWhenUnrated" min="0" max="10" step="0.1" />
@@ -129,6 +140,7 @@
document.querySelector('#ApplyTags').checked = config.ApplyTags;
document.querySelector('#TagName').value = config.TagName;
document.querySelector('#MaxRatingScore').value = config.MaxRatingScore;
document.querySelector('#MinCommunityRating').value = config.MinCommunityRating;
document.querySelector('#MinCommunityRatingWhenUnrated').value = config.MinCommunityRatingWhenUnrated;
document.querySelector('#RespectManualUntag').checked = config.RespectManualUntag;
Dashboard.hideLoadingMsg();
@@ -145,6 +157,7 @@
config.ApplyTags = document.querySelector('#ApplyTags').checked;
config.TagName = document.querySelector('#TagName').value;
config.MaxRatingScore = parseInt(document.querySelector('#MaxRatingScore').value, 10);
config.MinCommunityRating = parseFloat(document.querySelector('#MinCommunityRating').value);
config.MinCommunityRatingWhenUnrated = parseFloat(document.querySelector('#MinCommunityRatingWhenUnrated').value);
config.RespectManualUntag = document.querySelector('#RespectManualUntag').checked;