Concert Film Metadata Annotated

<video>

Video (required)

Begins the video element. Only one video element can be defined per film XML.

<subtype>concert</subtype>

Video Subtype (required; can be updated)

This value indicates how Apple should represent this video in the Apple TV app. The only accepted value for concert films is video subtype concert.

<country>US</country>

Country (required if not using <countries_of_origin>; , ISO-3166-1 country code)

The ISO 3166-1 alpha 2 code of the country/region where the film was primarily produced.

Notes:

• If there are multiple countries associated with the content, you can supply the countries using the newer <countries_of_origin> tag, listing one country as primary: <country primary="true">US</country>. Currently, both the <country> tag and <countries_of_origin> tag are supported, and you must deliver one or the other. The <countries_of_origin> tag is optional, but at some point in the future, it will be required and <country> will be deprecated. If you do not supply the <countries_of_origin> tag at that time, you will see a warning message that the tag is required. At a date in the future, the delivery will fail.

• You can’t use both the <country> tag and the <countries_of_origin> tag in the same delivery. If you do, delivery will fail.

• See Basic Film Metadata Annotated for information on using the <countries_of_origin> tag.

For a list of ISO 3166-1 alpha-2 codes, see https://www.iso.org/obp/ui/#search/code/.

For more information on ISO codes, see https://www.davros.org/misc/iso3166.html.

<production_company>Warner Bros.</production_company>

Production Company (required; 1-255 bytes; can be updated)

The customer-presentable name of the production company that created this concert film. Only one production company can be specified. If the concert film does not have an associated production company, supply the label name in the <production_company> tag.

<theatrical_release_date>2007-01-23</theatrical_release_date>

Theatrical Release Date (required)

This is the date the concert film was first released in theaters for the specified territory. If a concert film was not released theatrically, use the date it was first released physically or digitally.

The date must be in the format YYYY-MM-DD where YYYY is the 4-digit year, MM is the 2-digit month, and DD is the two-digit day.

This field does not impact date of release or “street date” in the Apple TV app.

Important: If you do not know the exact theatrical release date, you can specify just the year in YYYY-01-01 format. The Apple TV app displays the date as YYYY.

<genres>

  <genre code="CONCERT-FILMS-00"/>

</genres>

Genre (required; may be updated)

Concert films should use the "CONCERT-FILMS-00" genre. Using the Apple genre code is required.

<ratings>

Ratings (required; can be updated)

You must specify one or more ratings for your concert film content. For complete details, see the Overview in the “Film Ratings, Advisories, and Genres” section.

<rating system="mpaa" reason="Content contains adult material." code="UR"/>

Rating (required; can be updated)

A valid rating from an accepted ratings system. More than one rating can be specified, but only one rating per ratings system is allowed. If the film is not rated, choose the appropriate rating for Unrated or Not Rated (see the Overview in the “Film Ratings, Advisories, and Genres” section an explanation of Unrated and Not Rated). For countries/regions that do not have an Unrated or Not Rated classification, you must choose another rating. The information sent with this tag can be updated.

All film ratings have a short, plain-ASCII Apple rating code, which is supplied using the attribute named code. Standardizing on the Apple rating codes reduces errors resulting from typos and removes the need to enter escape codes for ratings in some languages.

The code attribute is required. The following are currently supported for delivering rating information:

Required method using the rating code:

• <rating code="PG-13"/>

Acceptable method using both the rating code and the rating label:

• <rating code="PG-13">PG-13</rating>

• If you use this method, the rating identified by code and the rating identified by the rating label must resolve to the same rating, for example, <rating code="UR">PG-13</rating> would be rejected.

To view a list of rating codes, you can download it from Film Ratings.

</ratings>

<artists>

  <artist>

    <artist_name>Madonna</artist_name>

    <apple_id>20044</apple_id>

    <roles>

      <role>Performer</role>

      <role>Creator</role>

    </roles>

    <primary>true</primary>

  </artist>

</artists>

Video Artists (required)

Name, primary status, and roles for each artist. In this context, "artist" may be any contributor including non-performing persons (for example, producer), or groups (for example, a band name). Individual artists should be listed separately and not grouped together (for example, "Ella Fitzgerald", "Louis Armstrong" should be used instead of "Ella Fitzgerald and Louis Armstrong"), and individual members of a band may be listed (for example, both "Harry Connick, Jr. Trio" (primary) and "Harry Connick, Jr." may be specified for a production).

Artist: You can refer to the artist by name (using the <artist_name> tag or by Apple identifier (using the <apple_id> tag). Apple assigns every artist a unique Apple identifier; Apple recommends using the Apple identifier to avoid the ambiguity in cases where artists share the same name as other music artists, or film actors or crew members. You can supply the <artist_name>, the <apple_id>, or both the <artist_name> and <apple_id>. If you supply both tags, the <artist_name> tag will be ignored in favor of the Apple identifier. If you do not know the artist's Apple identifier, you can do a metadata lookup on an existing album by the artist and look for the <apple_id> tag.

Role

Use the <role> tag to define the part that a particular artist performs on the musical piece. Some roles are required (as shown in the list below) and other roles are optional. See Recommended Contributor Roles for a list of all the roles recognized by the Apple TV app.

• Performer: always required.

• Songwriter (or Composer): always required. Note that songwriter and composer are often used to refer to the same contributor; you can specify either songwriter or composer to refer to an artist, but at least one of those roles is required.

• Featuring (or With): required if there is a featured artist on the musical piece. Adding the artist with the Featuring or With role ensures that the concert film will show up on the featured artist’s page.

Additional roles (such as Lead Guitar, Lead Vocals, Producer) are optional, but highly recommended. See Recommended Contributor Roles for a list of recommended contributor roles. If your exact role is not mentioned in the tables, you can still deliver it. These recommendations are included to ensure commonly-used roles are formatted consistently.

Note: You can use the following roles to designate the songwriter: <role>Composer</role>, <role>Lyricist</role>, or <role>Songwriter</role>. You can add as many songwriters/composers as needed for the musical piece. Failure to add full and accurate songwriter metadata in a timely manner may delay payment of royalties to publishers and songwriters.

Primary Status

Primary status indicates whether or not the concert film appears on the artist’s page in the Apple TV app. Typically, there are one or two primary (lead) artists and several supporting artists. Primary status is reserved for the primary (lead) artists. Do not tag supporting artists or contributors as primary.

There is a 255-byte limit strictly enforced. The data is stored in the UTF-8 encoding, so for single-byte characters (such as those drawn from the ASCII character set), this equates to a 255-character limit; for multiple-byte (for example, Japanese) characters, this can equate to as few as 71 characters.

<cue_sheet>

Cue Sheet (optional for U.S., otherwise required; can be updated)

Provides a list of music played in a concert film.

Important: Cue sheets are required for publishing purposes if the concert film will be sold or rented outside of the United States. If the concert film will only be sold in the U.S. market, then no cue sheet is required.

<cue>

Cue (required)

Begins a description of a musical piece played in a concert film. There can be multiple cue elements in a cue sheet.

<sequence_number>1</sequence_number>

Sequence Number (required)

The order number for the musical piece in the concert film. This value should be unique for each musical piece listed in the cue sheet.

<time>

Time (required)

The time element describes when a musical piece appears in the production and its duration.

<start_timecode>00:00:27</start_timecode>

Start Time-code (optional)

Specifies the start time of the musical piece in the production.

Note: The format of this value is HH:MM:SS (hours:minutes:seconds).

<duration>00:08:00</duration>

Duration (required)

Specifies the length of time the individual musical piece featured within the production.

Note: The format of this value is HH:MM:SS (hours:minutes:seconds).

</time>

<title>Future Lovers / I Feel Love</title>

Title (required)

The title of the musical piece. This tag should be used for titles based on ISO Latin-1 and Latin-2 language (i.e., English, French). For details for other languages, refer to Multiple Language Films.

For single-byte characters (such as those drawn from the ASCII character set), there is a limit of 256 characters for track titles. For multiple-byte characters (for example, Japanese), the limit is 1024 bytes, which can equate to as many as 256 characters.

<artists>

  <artist>

    <artist_name>Madonna</artist_name>

    <apple_id>20044</apple_id>

    <roles>

      <role>Performer</role>

      <role>Creator</role>

    </roles>

  </artist>

...

</artists>

Artists (required)

Name or Apple identifier and roles for each artist in the musical piece. In this context, "artist" may be any contributor including non-performing persons (for example, producer) or composition-related contributors (for example, songwriter/lyricist or composer). Individual artists should be listed separately and not grouped together (for example, "Ella Fitzgerald", "Louis Armstrong" should be used instead of "Ella Fitzgerald and Louis Armstrong"). Note that you should always include composition-related contributor information to the extent you have it.

Artist

You can refer to the artist by name (using the <artist_name> tag or by Apple identifier (using the <apple_id> tag). Apple assigns every artist a unique Apple identifier; Apple recommends using the Apple identifier to avoid the ambiguity in cases where artists share the same name as other music artists, or film actors or crew members. You can supply the <artist_name>, the <apple_id>, or both the <artist_name> and <apple_id>. If you supply both tags, the <artist_name> tag will be ignored in favor of the Apple identifier. If you do not know the artist's Apple identifier, you can do an Artist Lookup in Transporter. For any subsequent updates, you can use the <apple_id> tag instead of or in addition to the name, to avoid ambiguity.

Role

Use the <role> tag to define the part that a particular artist performs on the musical piece. Some roles are required (as shown in the list below) and other roles are optional. See Recommended Contributor Roles for a list of all the roles recognized by the Apple TV app.

• Performer: always required.

• Songwriter (or Composer): always required. Note that songwriter and composer are often used to refer to the same contributor; you can specify either songwriter or composer to refer to an artist, but at least one of those roles is required.

• Featuring (or With): required if there is a featured artist on the musical piece. Adding the artist with the Featuring or With role ensures that the concert film will show up on the featured artist’s page.

Additional roles (such as Lead Guitar, Lead Vocals, Producer) are optional, but highly recommended. See Recommended Contributor Roles for a list of recommended contributor roles. If your exact role is not mentioned in the tables, you can still deliver it. These recommendations are included to ensure commonly-used roles are formatted consistently.

Note: You can use the following roles to designate the songwriter: <role>Composer</role>, <role>Lyricist</role>, or <role>Songwriter</role>. You can add as many songwriters/composers as needed for the musical piece. Failure to add full and accurate songwriter metadata in a timely manner may delay payment of royalties to publishers and songwriters.

Primary Status

Primary status indicates whether or not the concert film appears on the artist’s page in the Apple TV app. Typically, there are one or two primary (lead) artists and several supporting artists. Primary status is reserved for the primary (lead) artists. Do not tag supporting artists or contributors as primary.

<isrc>USWB10606544</isrc>

ISRC (optional)

The ISRC (international standard recording code) for the musical piece. ISRCs must be unique across all recordings. It is normal for an ISRC to appear more than once if the same recording is included in more than one production (for example, an album, music video, TV episode, or film). In this case, the musical piece must have exactly the same audio. A re-recorded, remixed or otherwise different (no matter how similar) musical piece must have a unique ISRC.

Important: ISRCs must not include dashes and should remain only letters and numbers as in the example, USDP20707421.

<iswc>T0723712091</iswc>

ISWC (optional)

The ISWC (international standard work code) for musical works. This uniquely identifies intellectual property such as musical and literary works.

<copyright_cline>2006 Warner Bros. Records Inc.</copyright_cline>

Copyright © Line (optional; can be updated)

Copyright line for the musical piece. The format required is year followed by owner. The appropriate © symbol will automatically be added and should not be included in the data.

<copyright_pline>2006 Warner Music</copyright_pline>

Copyright P-Line (optional; can be updated)

Performance copyright line for the musical piece. The format required is year followed by owner. The appropriate ℗ symbol will automatically be added and should not be included in the data. Some videos don't have this P-line in the slate. Remove this tag if this is the case.

<usage>Featured</usage>

Usage (optional)

Specifies how the musical piece was featured in the production. Use one of the following values:

• Background: music that is not audible to the characters in the production, such as “mood music.”

• Featured: music played by featured performers, or as part of the action presented and is audible to the characters, such as the character dancing to a song.

• Signature: theme tune of a production or program.

    </cue>

  </cue_sheet>

</video>