- 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 playbackAspect Ratio (Flat and Scope)
Aspect ratio is the width of the picture divided by its height. Cinema runs on two standards: flat, at 1.85:1, and…
Projection and playbackB-Chain and X-Curve
The B-chain is the part of a cinema's sound system from the processor output to the room — amplifiers, loudspeakers and…
Projection and playbackCinema Masking
Masking is the movable black border that frames the screen to the aspect ratio of what is playing — and a missed…
CPLComposition Playlist
The CPL is the XML file inside a DCP that defines the composition — which track files play, in what order, for how long…