There is a special Apple iTunes atom it is called:
Atom "----" [com.apple.iTunes;iTunMOVI]
This Atom is used to display various things regarding the file. It is unique in that it is an XML file and can contain lots of various data. The data is displayed in iTunes and Apple TV.
The contents of this atom look similiar to below:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>copy-warning</key> <string>Help control the pet population. Have your pets spayed or neutered.</string> <key>studio</key> <string>A HolyRoses Production</string> <key>producers</key> <array> <dict> <key>name</key> <string>HolyRoses</string> </dict> </array> </dict> </plist>
Basically it is broken down into keys, strings, arrays, dict.
Known array type values:
cast codirectors directors producers screenwriters
These arrays are broken down into multiple dict, key, string. Example above only has 1 entry in the array. iTunes associates each Actor, director, screen writer, etc to an integer value. I can only assume they assign a value to each person and then can look it up in a database. This value is not needed for display purposes however.
Other known top level keys are:
copy-warning asset-info studio
asset-info has subkeys of file-size and screen-format.
The only value displayed in iTunes is "copy-warning". This value is displayed in iTunes if you right click on the item and select "Get Info". It is at the bottom of the screen.
On Apple TV the following values are displayed:
For ALL video: studio (displayed while video is playing and you press up arrow 2x to display the info, studio is displayed under Title)
For a TV show: cast (displayed as Actors on main info page)
For Movie: cast (displayed as Actors on main info page) directors producers
Music Video: nothing displayed other than studio.
Things with multiple values are displayed seperated by commas.
Items may be displayed on newer Apple devices such as an iPhone, but unknown/untested
To inject this data into an MP4 file you must use AtomicParsley and the --rDNSatom. An example is provided below.
AtomicParsley Video.m4v --rDNSatom "
cat HolyRoses-iTunMOVI.txt" name=iTunMOVI domain=com.apple.iTunes
Example atoms are provided from a iTunes store video called "Street Kings"
You can use this to see the full example syntax.
another file HolyRoses-example-iTunMOVI.txt is provided that just shows some basic data.
The only values that are known to display (according to me) anyplace at this time are copy-warning, studio, cast, directors, producers.
Proper support should be built to allow one to assign values to these items on the command line such as -actors "blah man","blah girl","Blah boy" -director "good director" -producer "chuck norris" -studio "Papa Johns" -copy-warning "dont copy this"
Attachment has text file examples and this read me.