EXAMPLE_2026.itmsp — Sample Apple iTunes / Apple TV film metadata package
=========================================================================

This is a SKELETON .itmsp package. It contains a minimal, well-formed
metadata.xml that you can clone, edit, and ship as your own first-time
delivery to Apple TV / iTunes.

What's in here
--------------
  metadata.xml   The Apple-schema XML describing the title, cast, ratings,
                 chapters, asset references, and per-territory rights/pricing.

What's NOT in here
------------------
The asset binaries that metadata.xml references (the master video, trailer,
poster, captions). Apple expects these in the same directory as metadata.xml,
with filenames matching the <file_name> values in the XML, and with sizes
and MD5 checksums matching the <size> and <checksum> values.

Files referenced by this metadata.xml:
  EXAMPLE_2026.mov              Full feature master
  EXAMPLE_2026-preview.mov      Trailer (worldwide default)
  EXAMPLE_2026.jpg              Poster (worldwide default)
  EXAMPLE_2026-english.scc      EIA-608 closed captions

To turn this skeleton into a real delivery
------------------------------------------
1. Rename this directory from EXAMPLE_2026.itmsp to <your-vendor-id>.itmsp.
   Vendor ID rules: alphanumeric + underscore only, case-sensitive,
   cannot start with underscore, no spaces or dashes.

2. Edit metadata.xml. Every value marked "<!-- REPLACE -->" needs to be
   filled in with your real data. At minimum: provider, vendor_id, title,
   synopsis, copyright, production_company, theatrical_release_date,
   genre, rating, cast/crew, chapters.

3. Drop your real asset files into this directory and rename them to match
   the <file_name> values in metadata.xml (or update metadata.xml to match
   your filenames).

4. Compute the MD5 checksum and byte size of every asset file and update
   the <size> and <checksum> values in metadata.xml. On macOS:
     md5 -q EXAMPLE_2026.mov         # MD5 hash
     stat -f%z EXAMPLE_2026.mov      # file size in bytes
   On Linux:
     md5sum EXAMPLE_2026.mov         # MD5 + filename
     stat -c%s EXAMPLE_2026.mov      # file size in bytes
   On Windows (PowerShell):
     Get-FileHash EXAMPLE_2026.mov -Algorithm MD5
     (Get-Item EXAMPLE_2026.mov).Length

5. Add per-territory <product> blocks for every country you have rights
   to sell in. The two in the skeleton (US, GB) are placeholders.

6. Validate locally with Apple's Transporter CLI:
     iTMSTransporter -m verifyPackage -f <your-vendor-id>.itmsp
   This runs schema validation, MD5 verification, and a sanity pass on
   dates and references. Fix anything it complains about before uploading.

7. Upload:
     iTMSTransporter -m upload -f <your-vendor-id>.itmsp -u USER -p PASS

8. Check status of the in-flight upload:
     iTMSTransporter -m status -vendor_id <your-vendor-id>

References
----------
  Apple Transactional Film Specification (current):
    https://help.apple.com/itc/filmspec/

  Apple Schema Validation Guide:
    https://help.apple.com/itc/schemavalguide/

  Transporter User Guide:
    https://help.apple.com/itc/transporteruserguide/

  Apple Transactional Film Rating Codes (controlled vocabulary):
    https://tvpartners.apple.com/assets/transactional-movies-rating-codes.zip

  OpenRights walkthrough (the why and when):
    https://openrights.blog/insights/apple-tv-delivery-templates-explained/
