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.
Set up your signer certificate and the key your DKDMs are addressed to, import a DKDM and an FLM, book the screens, and issue.
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.
Grouped by the job in front of you, from the cinema list to the ZIP in the cinema's inbox.
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.
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.
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'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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
KDM Courier is a Tauri app over the kdm_distribution module of postkit, where all of the KDM logic is. Contributions welcome.
git clone --recurse-submodules https://github.com/PostPerfection/kdmcourier.git
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.
Cinemas, FLM import, certificate checks, issuing, email and the database are in postkit, shared with DCP Wizard.