1. Home
  2. Cinema glossary
  3. Key Delivery Message
Projection and playback

KDM (Key Delivery Message)

A KDM is a small XML file that unlocks an encrypted DCP — for one named playback device, and only between a start and an end time.

Also written: KDM

Why a key exists at all

The track files inside a commercial DCP are encrypted with AES-128. The content keys that undo that encryption are not shipped with the package. They are sent separately, wrapped so that exactly one piece of hardware can open them.

Every compliant media block carries a certificate with a public key and a serial number. When a distributor issues a KDM they encrypt the content keys against that specific certificate. The result is a file of a few kilobytes that is worthless on any other device in the world — which is why a KDM can safely be emailed while the DCP itself cannot be.

This is also why KDM requests need your device certificates, not your address. A booking is made per screen, and the key is cut per screen. Four screens playing the same title on the same weekend need four KDMs.

What a distributor needs from you

DetailWhy they need it
Media block serial number and certificateThe key is encrypted against this exact device
The CPL UUID of the version you holdA 2D and a 3D version of the same title are different compositions
Screen numberSo the key can be matched back to the booking
First and last performance dateThe validity window is cut around these
Your projector's clock accuracyA device whose clock has drifted will reject a valid key

Most of this lives in your TMS and can be exported. Cinemas that keep a current certificate file on hand get keys back in minutes rather than on the morning of the show.

The validity window is the thing that bites

A KDM does not simply work or not work. It works between two timestamps, and both ends matter.

Keys usually open a little before the first booked performance and close a little after the last one, with some slack on each side. Two failure modes follow from that, and between them they account for most of the emergencies:

The show that will not start. Either the key has not arrived, or it arrived for a different screen, or the booking was extended and nobody asked for a new key. Extending a run is a commercial decision that silently creates a technical task.

The show that stops. The window closed mid-performance. This happens on late sessions at the end of a run, and it is why the end time of the last key of a run is worth checking rather than assuming.

A third, rarer one: the playback device's real-time clock has drifted or been reset after a power event. The key is fine; the device thinks it is a different date. Nothing about the error message will tell you that.

Answers

Frequently asked questions

Can a KDM be reused on another screen?

No. It is cryptographically bound to one media block's certificate. Moving a title to a different auditorium requires a new key for that auditorium's device.

What happens if a KDM expires mid-show?

Playback stops. The only fix is a new key with a later end time, so if a run is being extended, request the keys at the same time the booking changes.

How long do KDMs take to arrive?

Automated distributors return them in minutes. Smaller ones and repertory titles can take a working day or more, which is the case for requesting well before the first performance rather than on the day.

Do unencrypted DCPs need a KDM?

No. Most advertising, trailers and a good deal of festival and repertory content ships unencrypted and plays as soon as it is ingested.