Tuesday, June 10, 2008

iTunes content ratings

Purchased content from the iTunes store has embedded tags that identify the content’s rating. If you use a tool like AtomicParsley, you’ll see an output line that looks something like these data:

Atom "----" [com.apple.iTunes;iTunEXTC] contains: us-tv|TV-14|500|V
Atom "----" [com.apple.iTunes;iTunEXTC] contains: mpaa|PG-13|300|For violence and sexuality.

So I’m not here to discuss the ins-and-outs of how to get the correct atoms into your MP4 file; I’ll let AtomicParsley take care of that. However, I’m here to outline exactly what these tags mean to iTunes. Here’s a more accurate description of what those tags contain:

standard|rating|score|reasons

Where the standard tells iTunes which organization’s standards are being described by the rating. For the United States, these are us-tv for TV shows and mpaa for movies. A reference table with known standards, ratings, and scores is below.

The rating field gives the textual name of the rating given to this content. If iTunes does not recognize the string you give as a rating, it will choke on the file and fail to parse other metadata.

The score gives a numerical value which is used by the parental controls to limit access to media. Presumably, this is categorized such that restricted content from differing nations can still be restricted based on this number, even if the rating scales differ.

The reasons field is an arbitrary area where causes for the given rating can be noted. For us-tv ratings, for example, this includes the single-letter codes used to denote the presence of Violence (V), Language (L), Sexual Content (S), Dialogue (D), or Fantasy Violence (FV). For mpaa it seems to be an arbitrary string. iTunes does not expose this data currently, but it may in the future, so it’s a good idea to set it to something meaningful.

Rating Tables

AU: Movie ratings (au-movie)

  • 000: Not Rated
  • 100: G
  • 200: PG
  • 350: M
  • 375: MA 15+
  • 400: R18+
  • ???: Unrated

AU: Television ratings (au-tv)

  • Listed as N/A in iTunes

CA: Movie ratings (ca-movie)

  • 000: Not Rated
  • 100: G
  • 200: PG
  • 325: 14
  • 400: 18
  • 500: R
  • ???: Unrated

CA: Television ratings (ca-tv)

  • 000: Not Rated
  • 100: C
  • 200: C8
  • 300: G
  • 400: PG
  • 500: 14+
  • 600: 18+
  • ???: Unrated

FR: Movie ratings (fr-movie)

  • Listed as N/A in iTunes

FR: Television ratings (fr-tv)

  • 000: Not Rated
  • 100: -10
  • 200: -12
  • 500: -16
  • 600: -18
  • ???: Unrated

DE: Movie ratings (de-movie)

  • Listed as N/A in iTunes

DE: Television ratings (de-tv)

  • 000: Not Rated
  • 100: ab 6 Jarhen
  • 200: ab 12 Jarhen
  • 500: ab 16 Jarhen
  • 600: ab 18 Jarhen
  • ???: Unrated

NZ: Movie ratings (nz-movie)

  • 000: Not Rated
  • 100: G
  • 200: PG
  • 300: M
  • 325: R13
  • 350: R15
  • 375: R16
  • 400: R18
  • 500: R
  • ???: Unrated

UK: Movie ratings (uk-movie)

  • 000: Not Rated
  • 100: U
  • 150: Uc
  • 200: PG
  • 300: 12
  • 325: 12A
  • 350: 15
  • 400: 18
  • 600: E
  • ???: Unrated

UK: Television ratings (uk-tv)

  • 000: Not Rated
  • 500: CAUTION
  • ???: Unrated

US: MPAA ratings (mpaa)

  • 000: Not Rated
  • 100: G
  • 200: PG
  • 300: PG-13
  • 400: R
  • 500: NC-17 (unverified)
  • ???: Unrated

US: Television ratings (us-tv)

  • 000: Not Rated
  • 100: TV-Y
  • 200: TV-Y7
  • 300: TV-G
  • 400: TV-PG
  • 500: TV-14
  • 600: TV-MA (unverified)
  • ???: Unrated
Posted by Paul at 1:23 AM Perma-link | 2 comments | Links to this post |

Comments (Add)

Posted by संदीप at 4:08 AM, December 28, 2009:  

is there a way I can set this ratings in my video file using atomicparsley

Posted by bulletp2000 at 2:38 PM, December 10, 2011:  

Yes, you can set the content-rating tags using the FORKED version of AtomicParsley.
What is the forked version? The original developers of AP stopped working on it in 2006 -- there hasn't been a new release since then.

However, Wez and some other developers have carried the torch and you can get an updated version of AP (with newer features) over at bitbucket.org
https://bitbucket.org/wez/atomicparsley

I don't know why they don't have a link to this at the actual AtomicParsley web site.

This release has a couple of new features
--ratings-list (to get a list of ratings)
--contentRating TV-MA (to set a track to TV-MA)

It took me several different web sites to figure this out. Here's hoping this saves someone some effort!