Get a working KDM to
every booked screen

KDM Courier keeps your DKDMs, imports cinemas from FLM files, checks every certificate before a KDM is written, and writes or emails one ZIP per cinema. It is for small distributors, sales agents, filmmakers who distribute their own films, and post houses that key screenings.

Download for free See what it does

Download the desktop app

Set up your signer certificate and the key your DKDMs are addressed to, import a DKDM and an FLM, book the screens, and issue.

Windows

Installer .exe / .msi, x86_64

Download latest

macOS

.dmg, Apple Silicon

Download latest

Linux

.AppImage / .deb / .rpm, x86_64

Download latest

The macOS app is not notarized, so the first time it is blocked, open System Settings, Privacy & Security, and choose Open Anyway. Make the AppImage executable with chmod +x before running it. The Windows installers are unsigned, so if SmartScreen stops one, choose More info, then Run anyway.

Free and open source under the AGPL. No licence key, no seat limits, no subscription.

From DKDM to every screen

Grouped by the job in front of you, from the cinema list to the ZIP in the cinema's inbox.

Cinemas and screens

Cinemas from FLM files

Import a SMPTE ST 430-16 or ST 430-7 Facility List Message. Each suite becomes a screen, with its SM certificate as the KDM recipient and its other devices as the authorized devices the KDM lists. The time zone comes from the FLM or is typed in, and a cinema's email addresses can be edited.

Certificate status per screen

Each screen shows its certificate chains checked against ST 430-2 rules 1 to 18 as of today, as ISDCF Doc 5 Annex A asks, with each failure and warning listed.

FLM updates

Import a new FLM for a cinema already listed and its screens are matched by name. The import lists each screen added, removed, or with a changed recipient or authorized device certificate, and the bookings whose KDMs need issuing again because of it.

DCP Wizard import

DCP Wizard's cinemas.json imports as it is, and each screen whose certificate cannot be read is listed as skipped. Its kdm-history.jsonl imports into the Outbox's list of issued KDMs.

Titles and bookings

Titles from DKDMs

Import DKDM adds a title with its CPL id, its SMPTE or Interop standard read from an ISDCF name, and the DKDM's own validity window.

Bookings per screen

A booking is a title, the screens, and a start and end in each cinema's local time. The formulation comes from each screen's devices, or you pick Modified Transitional 1, Multiple Modified Transitional 1, DCI any or DCI specific. Edit changes the screens, dates and formulation. Remove deletes a booking.

Per-screen reissue

A screen needs a KDM until one is issued, and again after a new window, a new formulation or a changed certificate. The list marks those screens and counts them, as in "2 of 3 screens need a KDM". Issue covers only those screens. Issue all again covers every screen.

Bookings ending soon

A booking that ends within 3 days at any of its cinemas shows how many days or hours are left, and the Cinemas view counts those bookings per cinema. Extend the end date for a holdover and the issued screens are marked for reissue.

Issue pending at one cinema

A cinema with booked screens that need a KDM shows their count. Issue pending shows each booking's plan for its pending screens there. Issue then writes one ZIP per booking to the KDM folder from Settings and emails it when asked. A booking that fails is listed with its title and error, and the others still issue.

Checks before a KDM is written

Check before you issue

Check shows each screen's formulation, window and warnings, and the screens that would be refused with the rule they fail. It covers the screens that need a KDM, or every screen when none do. Nothing is written until you press Issue.

What a screen must pass

The signer chain is checked at the issue date and at both ends of the window. The recipient and authorized device chains are checked against ISDCF Doc 5 Annex A, and the window must sit inside the recipient certificate's validity. A formulation that lists devices is refused for a screen with none, and a DCI formulation is refused for an Interop title. A window that reaches outside the DKDM's validity is a warning.

Windows in the cinema's time zone

A cinema needs a time zone before it can be booked. The window is written in that zone's local time, and a window across a clock change carries both offsets. A start or end time the clocks skip is refused.

Delivery and records

One ZIP per cinema

KDMs are written as one ZIP per cinema, named by the 2009 KDM Naming Convention, with its KDMs beside it in a folder of the same name. They go to a folder you type or pick, or to the KDM folder from Settings.

Email over SMTP

Tick Email and each cinema's ZIP goes to its addresses over TLS, STARTTLS or plain SMTP, with the ZIP name as the subject and your message with the title and cinema filled in. The SMTP password stays in a settings file, readable only by you on Linux and macOS, and is never shown in the app.

Outbox with resend

The Outbox lists every KDM issued and every ZIP written or emailed, with its title and the SMTP result. Resend mails a ZIP again to the cinema's addresses as they are now and records it as a new delivery. A removed booking's KDMs stay in the Outbox.

Expiry view

Lists each recipient certificate, authorized device certificate and DKDM that expires before a running booking ends, and the signer chain's certificates with the bookings that end after them. A booking at a cinema with no usable time zone is listed as not checked.

Signer and settings

Settings holds the signer certificate, its key and the CA certificates above it, the key your DKDMs are addressed to, the three letter creation facility code, the KDM folder, the SMTP server and the database location.

For developers

KDM Courier is a Tauri app over the kdm_distribution module of postkit, where all of the KDM logic is. Contributions welcome.

1

Clone

git clone --recurse-submodules https://github.com/PostPerfection/kdmcourier.git

2

Run the desktop app

cd kdmcourier/gui && pnpm install && pnpm tauri dev

Building from source is Linux only for now. postkit links FFmpeg, which pkg-config must find at build time.

3

Built on postkit

Cinemas, FLM import, certificate checks, issuing, email and the database are in postkit, shared with DCP Wizard.

4

Source and issues

Build notes, tests and the AGPL-3.0 licence on GitHub.