- Home
- Cinema glossary
- Key Delivery Message
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
| Detail | Why they need it |
|---|---|
| Media block serial number and certificate | The key is encrypted against this exact device |
| The CPL UUID of the version you hold | A 2D and a 3D version of the same title are different compositions |
| Screen number | So the key can be matched back to the booking |
| First and last performance date | The validity window is cut around these |
| Your projector's clock accuracy | A 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.
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.
Keep reading
Digital Cinema Package
A DCP is the standardised folder of files a cinema ingests and plays instead of a film print — compressed picture…
IMBIntegrated Media Block
The IMB is the board inside the projector that decrypts the DCP, decodes the JPEG 2000 picture and feeds the light…
TMSTheatre Management System
A TMS is the single console that controls every screen in the building — distributing packages, building show…
Projection and playbackLaser Projection
Laser projection replaces the xenon lamp in a cinema projector with a laser light source — either laser phosphor or RGB…
J2KJPEG 2000
JPEG 2000 is the image codec used for the picture in every Digital Cinema Package. Each frame is compressed on its own…
Material Exchange FormatMXF
MXF is the container format that holds the picture and sound track files inside a DCP — a wrapper, not a codec.
Projection and playbackInterop and SMPTE DCPs
Interop is the older, de facto DCP flavour that digital cinema launched on; SMPTE is the formally standardised…