Script - Parental Rating Copier from Show to Episodes

[ginjaninja 605]

Overwrites the parental rating of every episode with the parental rating of the show.

requested by @Oxide

notes

• Requires Powershell 7+
• Review config.psd1, add admin credentials, change $testmode to $false when ready to make changes
• as always test thoroughly on a backed up database.

changes

• v0.0.0.7 fixed incompatible endpoint in recent Emby versions.
• v0.0.0.6 amended some of the screen and logfile logging to improve clarity.

download

 

Parental Rating Copier v0.0.0.7.zip

issues suggestions welcome.

Edited June 9, 2025 by ginjaninja

[GrimReaper 4739]

Does it expose those ratings in the UI and show them in episode detail view? 

[ginjaninja 605]

4 hours ago, GrimReaper said:

Does it expose those ratings in the UI and show them in episode detail view? 

seems to , why is there a known gotcha to look out for with parental ratings?

[GrimReaper 4739]

Nope, none that I know of. Thanks. 

[Happy2Play 9780]

5 hours ago, ginjaninja said:

is there a known gotcha to look out for with parental ratings?

Not that I know of either, but by default genre and PR are inherited from Series but do not show on Episode.

Not sure how restrictions would apply if episode had different rating, then Series if this where to happen though.

This is where I discovered what I would have to say a legacy issue with episode genres as it only applied to specific episodes.

 

[GrimReaper 4739]

38 minutes ago, Happy2Play said:

Not sure how restrictions would apply if episode had different rating, then Series if this where to happen though.

But since the script is only copying Series rating to Episodes, that should never occur with its usage, only if rating was manually appended, which is something that anyone can do at any time without using the script anyway? 

Edited July 19, 2022 by GrimReaper

[GrimReaper 4739]

Worked like a charm. Thank you.

[chef 3810]

This is cool! Thanks for making this! 

[Oxide 139]

@ginjaninjaany chance you can make this into a plugin like you did for Geust Star Cleaner

[ginjaninja 605]

On 28/12/2023 at 15:53, Oxide said:

@ginjaninjaany chance you can make this into a plugin like you did for Geust Star Cleaner

accessing the emby web api from within the plugin environment was not trivial last time i looked and i havent found a way yet...the plugin environment's objects and methods sometimes were not equivalent to the simplicity of the web api but thats probably a testament to my lack of ability. I do need to get back into plugin learning but its going to be a few months before i have spare time...perhaps someone else can convert it?

[cremonies 11]

I'm sorry, I don't know what I'm doing but want this so I can use smart playlist to filter episode for my kids.

I have emby running on a Synology nas in a docker container.

Will it still work when running the script from a different computer?

[ginjaninja 605]

3 hours ago, cremonies said:

I'm sorry, I don't know what I'm doing but want this so I can use smart playlist to filter episode for my kids.

I have emby running on a Synology nas in a docker container.

Will it still work when running the script from a different computer?

yes, any device on network which supports powershell and can 'talk to' Emby server.

(there are no other prerequisites ..its just chatting http to the emby web api)

[Oracle 85]

3 hours ago, cremonies said:

I'm sorry, I don't know what I'm doing but want this so I can use smart playlist to filter episode for my kids.

I have emby running on a Synology nas in a docker container.

Will it still work when running the script from a different computer?

There is no reason it shouldn't.

[cremonies 11]

edit:

got it to work. thank you so much. I thought I updated power shell to 7 but it did not install.

 

Edited July 19, 2024 by cremonies

[Baenwort 118]

This should fix my issue with shows that get episode ratings from some meta sources but that I want to have the entire show access at another rating level using parental controls.

It is strange that there must be some use case when someone wants to set a different series rating but not have it carry to all episodes? I haven't thought of it but why else would this be needed?

[ebr 16168]

8 hours ago, Baenwort said:

It is strange that there must be some use case when someone wants to set a different series rating but not have it carry to all episodes? I haven't thought of it but why else would this be needed?

Imagine there is a series that, in general, is rated PG but they air one episode that has content in it that you consider not really PG.  You can change the rating of that one episode so that your younger children do not see it.

The reverse could also be true - an adult series that airs a Christmas special or something that you wouldn't mind your children seeing.

[atreyu4055 17]

This script used to work perfectly, but no longer works in Emby recent beta releases, I get 

When I paste the contents of the $ApiURL variable into Chrome, its Emby that is returning the error message.

 

Edited May 30, 2025 by atreyu4055

[ginjaninja 605]

The 0.0.0.6 script was using a now unintelligible endpoint....was working more by luck than judgement it seems..

have since changed and updated first post with 0.0.0.7

Ran it on my system once**, was surprised to find that nearly every show needed an update (i dont use the script myself)

**no  testing beyond that**.

 

It seems that almost no episodes have a parental rating on my system so they all needed updating....

 

maybe that was always the case...and im worrying unnecessarily but you may want to take a bit of extra care and backup database 1st or use testmode=$true in config.

[Baenwort 118]

Hello, I'm trying to use the new 0.7 script and I get this error in PowerShell:

 

Invoke-WebRequest : A parameter cannot be found that matches parameter name 
'SkipCertificateCheck'.
At V:\Parental Rating Copier v0.0.0.7\OfficialRatingCopier.ps1:52 char:117
+ ... e "application/json" -SessionVariable 'Session' -SkipCertificateCheck
+                                                     ~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Invoke-WebRequest], ParameterBindi 
   ngException
    + FullyQualifiedErrorId : NamedParameterNotFound,Microsoft.PowerShell.Commands.Inv 
   okeWebRequestCommand
 
ConvertFrom-Json : Cannot bind argument to parameter 'InputObject' because it is null.
At V:\Parental Rating Copier v0.0.0.7\OfficialRatingCopier.ps1:53 char:37
+ $serieslist = $serieslist.content | ConvertFrom-Json
+                                     ~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidData: (:) [ConvertFrom-Json], ParameterBindingVal 
   idationException
    + FullyQualifiedErrorId : ParameterArgumentValidationErrorNullNotAllowed,Microsoft 
   .PowerShell.Commands.ConvertFromJsonCommand

I do wish to note that although you named the zip file 0.7 the version number in both the config and the ps1 file in it say 0.6 still. Running Emby-Stable of 4.9.3.0

Edited January 16 by Baenwort

[ginjaninja 605]

the version numbers are not the issue..just me being sloppy...are you using powershell 7+ i know that is critical? 

edit

just tested on 4.9.4.1 Beta and still working...so im thinking your powershell version is the most likely culprit.

Edited January 17 by ginjaninja

[Baenwort 118]

I think I'm using a new enough one.

Error again with that output on the same shell:

Edited January 18 by Baenwort

[ginjaninja 605]

 

I think the winget command says what packages are installed but not what you are using. My blue powersheell is the old version for me. I launch powershell 7 via 'PWSH' in windows.

[Baenwort 118]

16 hours ago, ginjaninja said:

 

I think the winget command says what packages are installed but not what you are using. My blue powersheell is the old version for me. I launch powershell 7 via 'PWSH' in windows.

That seems to be correct. I changed my PS7 to be blue as I like that better than black so didn't see the difference. Execuiting $psversiontable.psversion showed I had the wrong one open.

 

[Baenwort 118]

Second, could you tell me if you'd support copying the 'Custom Rating' metadata field from the series to the episodes? I normally change that one so that it will show up for users without changing the displayed(offical) rating so that the original data is there for someone browsing but the series shows up for users with the custom rating level set as allowed.

Emby has that custom rating field, I presume for a reason, but this script only seems to check the official rating field.

[ginjaninja 605]

if you had interest in learning powershell/Emby api, u could make a copy of the script and tweak a couple of lines (backup database ofc)

$ApiURL = $EmbyURL + "/emby/Items?Recursive=true&Fields=Customrating%2COfficialrating%2CPath%2CPeople&ParentId=$($_.id)&IncludeItemTypes=Episode&api_key=$($user.AccessToken)"

You would need to add Customrating to the fields requested for each of the two api lookups....series and episodes..example above.

and then switch 'officialrating' to 'customrating' in at least these 4 places.

$seriesrating = $_.officialrating

$episoderating = $_.officialrating

#add officialrating property if api response does not include  -clause

$fullmetadata.officialrating = $seriesrating

 

if youve got as far as running powershell...tweaking the scripts might be next on the journey?