The certification XML file that is specified in mjb.xmlCertificationFile and defaults to certification-default.xml, is used to consolidate certifications from different countries or source sites into a set of certifications that are suitable for your jukebox.

To turn on this feature, you will need to edit your moviejukebox.properties file and set the following two parameters:

mjb.filter.certification=true
mjb.xmlCertificationFile=my-certification.xml

Note: You can call the certification file whatever you like (as long as it ends in XML), but you should change it from the default so that your changes are not overwritten when you update your installation.

The default file that is supplied, is not very useful and will need to be altered to suit your set-up.

Each certification that you want in your final jukebox will need it's own section that looks something like:

<certifications>
    <certification name="MasterCertification">
        ...
    </certification>
</certifications>

The MasterCertification is the name of the master certification that you want in the jukebox.

You now need to add the sub-certifications of the films that you want combined up into that master certification.

<certifications>
    <certification name="MasterCertification">
        <subcertification>Certification</subcertification>
        <subcertification>Another Certification</subcertification>
        <subcertification>Some Other Certification</subcertification>
    </certification>
</certifications>

You can have as many sub-certifications as you need for each MasterCertification, but the sub-certification should only exist once in the file.

You can also add one default certification. Any certifications that YAMJ comes across that don't match the subcertifications you've defined will be assigned this default certification.

<certifications>
    <certification name="MasterCertification">
        <subcertification>18</subcertification>
    </certification>
    <default>Default Certification</default>
</certifications>

The above settings will assign anything not rated as "18" to the certification "Default certification".

If you do not want a default certification, leave the default certification empty and YAMJ will leave certifications it doesn't recognise the way they are.

<default></default>

The following example will create 2 master certifications: Child & Adult. It will assign the certification of Child to all films that have a certification or certification of U, PG or 12A and Adult to R, 15 and any certification labeled as UNKNOWN or Not Rated.

Films with any other certification or certification will be assigned to the Adult certification, as it's specified as the default certification.

<certifications>
    <certification name="Child">
        <subcertification>U</subcertification>
        <subcertification>PG</subcertification>
        <subcertification>12A</subcertification>
    </certification>
    <certification name="Adult">
        <subcertification>R</subcertification>
        <subcertification>15</subcertification>
        <subcertification>UNKNOWN</subcertification>
        <subcertification>Not Rated</subcertification>
    </certification>
    <default>Adult</default>
</certifications>