DCP Wizard

Digital Cinema Package (DCP) creator, CLI tool and desktop GUI.

Version 1.1 creates consistent CPL, PKL, and ASSETMAP identities for SMPTE and Interop packages. Grok is the JPEG 2000 encoder.

Overview

DCP Wizard creates valid DCPs (Digital Cinema Packages) from video sources, image sequences, and WAV audio, conforming to SMPTE ST 429 (Bv2.1) and Interop standards.

Free and open-source alternative to easyDCP Creator+ (€2,998).

Features

DCP Creation & Packaging

Original Version (OV) DCP creation from J2K + WAV
SMPTE & Interop standard support
2K and 4K resolution (2048×1080, 4096×2160)
Frame rates 24, 25, 30 fps (2K/4K); HFR 48, 50, 60, 96, 100, 120 fps (2K only)
Reel splitting via create --reel-length <minutes> (multi-reel CPL, sample-accurate audio and per-reel subtitle boundaries)
Explicit reel splits via create --split-at <tc>[,<tc>...] (HH:MM:SS or HH:MM:SS:FF) or create --split-chapters (source chapter marks via ffprobe)
Custom picture container via create --container <2k-scope|...> or create --container-dims WxH (even, within the 2K/4K bound)
Head/tail padding via create --pad-head <dur> --pad-tail <dur> (48f/2s), with --pad-color <RRGGBB> for a filled pad instead of black
Input decode range override via create --input-range full|legal, correcting wrong or absent source range flags
High Bitrate (HBR), up to 500 Mbps for demanding content
CPL / PKL / ASSETMAP / VOLINDEX generation
Multi-version packages via create --versions <file>: one package with several CPLs sharing the same picture/sound essence, differing by subtitle and/or audio track (multiple language versions over one master)
Multi-composition packages via create-multi --compositions <manifest>: one CPL per manifest entry, each with its own picture/sound/subtitle, over one shared PKL/ASSETMAP
Assemble a new OV from existing DCPs via assemble --input <dcp>... --output --title (reels in order, essence copied byte-identical by UUID)
Edit CPL metadata (title/annotation/content-kind/issuer) without re-wrapping essence via edit --input
Decrypt an encrypted DCP to cleartext via decrypt --input --output with --kdm --recipient-key or --keys
Sign-language video track via create --sign-language-video <file> --sign-language-lang <rfc5646> (ISDCF Doc 13, SLVS on sound channel 15)
Bv2.1 CompositionMetadataAsset (ST 429-16) in the first reel of SMPTE CPLs, with MainSoundConfiguration derived from the packaged channel count
Re-ingest packaging via ingest-package <dir>: rebuild ASSETMAP and PKL to cover every asset file present (for exported OV/VF folders whose ASSETMAP/PKL omit hardlinked assets), no re-wrap
SHA-1 hashing for integrity verification

Encoding & Transcoding

JPEG 2000 encoding via Grok (create, pipeline, and DCP transcode paths)
Video file import, QuickTime (.mov), MP4, MXF, AVI, MKV
Video transcoding, ProRes, H.264, H.265, DNxHR → image sequence → J2K (via ffmpeg)
Image sequence input, DPX, TIFF, EXR, PNG
Scale / Crop / Letterbox, target resolution adaptation
Colour conversion to XYZ (DCI, gamma 2.6)
Encode QoL on create: --start-at (scheduled wall-clock start), --resume (reuse on-disk J2K frames after an interruption, survives restarts), average-fps ETA in progress output, --shutdown-when-done (power off after a clean encode)

Encryption & KDM

AES-128 essence encryption, content keys generated with a CSPRNG, encrypted at wrap time
Signed SMPTE KDM (ST 430-1 / 430-3) carrying the DCP's image and audio content keys
Batch KDM, generate for multiple screens in one pass
DKDM re-wrap, re-issue KDMs from a Distribution KDM
Certificate generation, X.509 cert chain (root → intermediate → signer)
Certificate inspection, display subject, issuer, validity, thumbprint, CA status

Subtitles & Captions

SRT → SMPTE / Interop subtitle XML conversion, anchored near the bottom with configurable --vposition (percent from the bottom, default 8%)
Subtitle packaging into a DCP timed-text track (ST 428-7 DCST wrapped as an MXF, registered in the CPL) via create --subtitle
Input formats beyond SRT: create --subtitle accepts .ass/.ssa (styling + alignment), .pac (EBU binary, Latin codepage), .mks/.mkv (Matroska subtitle stream via ffmpeg), .fcpxml (captions/titles) and an Interop DCSubtitle XML carrying PNG bitmap subs. Styling (italic/bold/underline/colour) and per-cue alignment/position are carried into the DCST; supplied SMPTE DCST XML is still wrapped unchanged.
Placement controls on create: --subtitle-halign left|center|right, --subtitle-valign top|center|bottom (top-anchored subtitles grow downward), --subtitle-vposition <pct>, so SRT is no longer always centred-bottom
3D subtitle depth via create --subtitle-zposition <v> (SMPTE ST 428-7 Zposition emitted on every cue). Note: the timed-text descriptor's "Z-Position In Use" flag is not set by the current asdcplib writer.
RTL subtitles (create --subtitle-rtl auto|on|off, default auto): Hebrew/Arabic is reshaped and reordered to visual order so servers that skip the bidi algorithm render it correctly
Auto line-wrap via create --subtitle-wrap <chars>: long lines wrap on whitespace (never mid-word), preserving styling
Font embedding + subsetting via create --subtitle-font <ttf/otf>: the font is subset to the used glyphs (SMPTE 640 KB limit, fails loud if exceeded) and embedded in the timed-text MXF, referenced by a LoadFont; --subtitle-no-subset embeds the whole font. Under reel splitting the font is referenced by one shared asset id in every reel.
Subtitle editing on standalone files via subtitle-edit: --list cues, --shift-ms all cues, or --index N with --text / --set-start-ms+--set-end-ms, written back as SRT (it edits source files, never subtitles inside a finished DCP)
Subtitle extraction from a DCP or subtitle asset back to .srt (timed) or .txt (text only) via subtitle-extract; reads MXF-wrapped ST 428-7 and loose SMPTE/Interop XML, concatenating reels with their timeline offsets
Multilingual subtitles with RFC 5646 language tags
Subtitle burn-in, permanently render into video frames (for festivals)

Audio

PCM audio wrapping (48 kHz)
Loudness measurement, EBU R128 / ATSC A/85
Loudness normalization to a target via create --loudness-target leqm=<db>|lufs=<v> (with --true-peak-ceiling)
Stereo→5.1 upmix at create via create --upmix a|b
Filename channel auto-routing: point create --audio at a directory of mono name_L.wav/_R/_C/_Lfe/_Ls/_Rs… files
Crossfade join of two WAVs via crossfade --a --b -o --overlap
Mid-side decode via mid-side-decode -i -o --mid --side
WAV audio input

Quality Control

Integrated QC via dcpdoctor (SMPTE Bv2.1 compliance checking)
HTML QC report generation
DCP verification, validate structure, hashes, XML schemas
Markers, FFOC, LFOC, FFTC, LFTC, FFOI, LFOI, FFEC, LFEC, FFMC, LFMC; the default set is FFOC/LFOC, place any of the others with --marker LABEL=timecode

HDR & Dolby Vision

HDR detection, auto-detect SDR, HDR10, HDR10+, Dolby Vision, HLG from source
Dolby Vision RPU injection via dovi_tool
HDR10 static metadata injection (SMPTE ST 2086 + CTA 861.3)
HDR format conversion, HDR10 ↔ HLG ↔ SDR tone mapping
HDR source delivery via create --hdr-to-dci-lut <lut> (runs the LUT before J2K encode); --allow-generic-hdr-tonemap opts into FFmpeg tone mapping with a warning. create --hdr-dci authors a DCI HDR Addendum DCP: the picture MXF is stamped with TransferCharacteristic=ST 2084 (PQ) and ColorPrimaries=P3-D65. Needs a PQ source path (--hdr-to-dci-lut or --hdr-already-pq); not available with 3D or reel splitting

Camera Ingest

Camera format detection (ARRIRAW, RED R3D, Blackmagic BRAW, Canon, Sony RAW / X-OCN); true RAW is detected and rejected loud, only ffmpeg-decodable masters (ProRes, DNxHR) transcode
Media scanning, auto-detect resolution, frame rate, codec, reel names
Transcode to intermediate, DPX, TIFF, EXR, ProRes 4444 (via ffmpeg)
3D LUT application during ingest via ingest --lut <lut.cube>
Timeline conform from EDL (CMX 3600) / FCP7 XML (xmeml) / FCPX (fcpxml): parse, or with --media-dir --output resolve every reel to media and build a finished multi-reel DCP (per-reel encode + wrap + CPL assembly). The reel/asset plan (conform_plan.json) and conform manifest are kept as artifacts

Export & Playback

Export DCP to ProRes, H.264, H.265, DNxHR, or image sequence
Frame extraction, extract individual frames as images (thumbnails/preview)
Frame-accurate preview with display colourspace selection

Delivery & Automation

Copy to drive with a free-space precheck and post-copy hash verification (USB/CRU); format-drive (ext2/ext3, volume label, mounted-target refusal) and check-drive (report fs type + label) for cinema hard-drive delivery
Watch folder mode, automated DCP creation on file arrival
Job queue with progress tracking and cancellation
REST API for headless/batch operation
Prometheus metrics endpoint (GET /metrics), job counts, daemon status for monitoring
Docker container for CI/CD pipelines
CLI scriptable, all features accessible from command line
Version dashboard, OV/VF management, territory tracking, distribution matrix export
Webhook notifications, HTTP callbacks on job completion/failure

Mastering & Compliance

DCDM creation, Digital Cinema Distribution Master (X'Y'Z' 12/16-bit) intermediate
Visible watermarking, burned-in text mark (distributor ID/serial) across image frames
Trailer packaging, ratings cards (MPAA/BBFC/FSK), green/red band, countdown leaders; the packaged mp4 is then encoded and wrapped into a real trailer DCP
Content version tracker, SQLite database of which version delivered where and when
Accessibility compliance, verify AD/HI/SL tracks against CVAA, EAA, AODA, Ofcom standards

Installation

Pre-built binaries (recommended)

Download from the GitHub Releases page:

Platform	CLI	Desktop GUI
Linux (x86_64)	`dcpwizard-linux-x86_64.tar.gz`	`.deb`, `.AppImage`
macOS (Apple Silicon)	`dcpwizard-macos-aarch64.tar.gz`	`.dmg`
Windows (x86_64)	`dcpwizard-windows-x86_64.zip`	`.msi`

The CLI links the Grok JPEG 2000 library (libgrokj2k) dynamically, so the Grok runtime must be present. Point LD_LIBRARY_PATH at Grok's lib64 (Linux) or the equivalent before running.

Install from source

Linux (Ubuntu/Debian)

sudo apt-get install -y pkg-config libxml2-dev libssl-dev libxerces-c-dev
# For GUI: also install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev

# Grok (libgrokj2k) must be discoverable by pkg-config at build time and its
# shared lib loadable at runtime. Build it from source or install a release, then:
export PKG_CONFIG_PATH="/path/to/grok/lib64/pkgconfig:$PKG_CONFIG_PATH"
export LD_LIBRARY_PATH="/path/to/grok/lib64:$LD_LIBRARY_PATH"

cd rust
cargo build --release
# Binary at rust/target/release/dcpwizard

macOS

brew install pkg-config libxml2 openssl@3 xerces-c

export OPENSSL_DIR=$(brew --prefix openssl@3)
export PKG_CONFIG_PATH="$(brew --prefix openssl@3)/lib/pkgconfig:$(brew --prefix libxml2)/lib/pkgconfig:$(brew --prefix xerces-c)/lib/pkgconfig"

cd rust
cargo build --release

Windows

# Using vcpkg (recommended)
vcpkg install libxml2 openssl xerces-c --triplet x64-windows

$env:VCPKG_ROOT = "$env:VCPKG_INSTALLATION_ROOT"

cd rust
cargo build --release

Optional runtime dependencies

Dependency	Purpose	Install
`ffmpeg`	Video transcoding and import	`apt install ffmpeg` / `brew install ffmpeg` / ffmpeg.org
`mpv`	GUI preview player	`apt install mpv` / `brew install mpv` / mpv.io

Docker

docker build -t dcpwizard .
docker run -v /path/to/media:/data dcpwizard create \
    --title "My Film" --video /data/j2k --audio /data/audio.wav --output /data/dcp

Desktop GUI

The GUI uses Tauri 2 (Rust backend + web frontend) with a single-window layout inspired by professional NLEs.

GUI features:

Drag & drop file import (video, audio, subtitle)
Keyboard shortcuts (Ctrl+N/O/B/P/I, Ctrl+1–7 for views)
Recent projects quick-access list
Right-click context menus on assets (Preview, Remove, Show in Files)
Asset filter / search
Auto-detect framerate and resolution from imported video (via ffprobe)
Progress in title bar (visible in taskbar during builds)
Desktop notifications on build complete/fail
Conditional button enabling (Build disabled until ready)
Built-in mpv preview player with timeline scrubber (click-to-seek, drag-to-scrub, timecode display)
Multi-CPL composition tabs, switch, add, remove compositions
SRT → SMPTE subtitle conversion panel
Subtitle extraction panel (DCP/asset → SRT or text)
Subtitle burn-in panel
Target resolution conversion panel (2K/4K scope/flat/full)
GPU encoding toggle (grok acceleration)

cd gui
pnpm install
pnpm tauri dev
pnpm tauri build

CLI Usage

# Create a DCP
dcpwizard create --title "My Feature Film" --video ./j2k --audio ./audio.wav --output ./dcp

# Create from video file (full pipeline: decode → J2K encode → MXF wrap → DCP)
dcpwizard create --title "My Film" --video movie.mov --output ./dcp

# Transcode an existing DCP's picture essence to a lower bandwidth (audio and
# subtitle tracks are copied unchanged; encrypted input is rejected)
dcpwizard transcode-dcp --input ./dcp --output ./dcp_light --video-bit-rate 100

# Create with encryption. Content keys are generated with a CSPRNG and the
# essence is AES-128 encrypted at wrap time. --key-out is required: it is the
# only place the keys are written (never next to the DCP). That file holds the
# plaintext keys, keep it secret and outside the DCP. Feed it to `kdm --keys`.
dcpwizard create --title "My Film" --video ./j2k --audio ./audio.wav --output ./dcp \
    --encrypt --key-out ./secret/my_film.keys.json

# Create a signed DCP. The CPL and PKL get an XML-DSig ds:Signature (SMPTE
# ST 429-7/-8), which encrypted packages require and validators such as
# ClairMeta expect. --signer-chain takes the CA certificates above the leaf,
# intermediate(s) then root, and is repeatable. Signing is opt-in: without
# --signer-cert the package is written unsigned as before. The private key is
# read straight from the file by dcpwizard, never passed to another process.
dcpwizard create --title "My Film" --video ./j2k --output ./dcp \
    --signer-cert signer.pem --signer-key signer.key \
    --signer-chain intermediate.pem --signer-chain root.pem

# Create Interop DCP
dcpwizard create --title "My Film" --video ./j2k --output ./dcp --standard interop

# Create with content type and resolution
dcpwizard create --title "My Trailer" --video trailer.mov --output ./dcp \
    --content-type TLR --fourk --video-bit-rate 500

# Create with frame rate override
dcpwizard create --title "My Film" --video ./j2k --output ./dcp --frame-rate 25

# Split a long feature into ~20-minute reels (multi-reel CPL)
dcpwizard create --title "My Feature" --video ./j2k --audio ./audio.wav \
    --output ./dcp --reel-length 20

# Explicit reel splits at timecodes, or at the source's chapter marks
dcpwizard create --title "My Feature" --video movie.mov --output ./dcp \
    --split-at 00:20:00,00:41:30:12
dcpwizard create --title "My Feature" --video movie.mov --output ./dcp --split-chapters

# Custom container: a named DCI container or arbitrary even dimensions
dcpwizard create --title "My Film" --video ./j2k --output ./dcp --container 2k-flat
dcpwizard create --title "My Film" --video ./j2k --output ./dcp --container-dims 1920x1080

# Head/tail padding with a coloured pad frame (48f or 2s; default black)
dcpwizard create --title "My Film" --video ./j2k --audio ./audio.wav --output ./dcp \
    --pad-head 2s --pad-tail 48f --pad-color 000010

# Force the source decode range (corrects wrong/absent range flags)
dcpwizard create --title "My Film" --video movie.mov --output ./dcp --input-range full

# Sign-language video track (ISDCF Doc 13, carried on sound channel 15)
dcpwizard create --title "My Film" --video ./j2k --audio ./audio.wav --output ./dcp \
    --sign-language-video signer.mov --sign-language-lang sgn-ase

# HDR source with an HDR-to-DCI 3D LUT (LUT runs before J2K encode)
dcpwizard create --title "My Film" --video hdr.mov --output ./dcp \
    --hdr-to-dci-lut hdr_to_dci.cube

# Create with a subtitle track (SRT -> ST 428-7 timed text, wrapped and registered)
dcpwizard create --title "My Film" --video ./j2k --output ./dcp \
    --subtitle subs.srt --subtitle-language en

# Multi-version package: one master, several CPLs differing by subtitle/audio.
# The base flags define the shared picture/sound; each versions.json entry is a CPL.
dcpwizard create --title "My Film" --video ./j2k --audio ./audio.wav \
    --output ./dcp --versions versions.json
# versions.json:
#   [
#     { "title": "My Film (EN)", "subtitle": "en.srt", "subtitle_language": "en" },
#     { "title": "My Film (FR)", "subtitle": "fr.srt", "subtitle_language": "fr" }
#   ]

# Stereoscopic 3D: main input is the left eye, --right-eye is the right eye
# (both encoded at the same settings, wrapped into one ST 429-10 picture MXF)
dcpwizard create --title "My 3D Film" --video left.mov --right-eye right.mov \
    --output ./dcp --frame-rate 24

# Dolby Atmos aux track (ST 429-18). Pass a bitstream file or a directory of
# per-frame payloads. Real-essence conformance needs real Atmos material.
# DTS:X: since ST 429-18/-19 it is delivered as a standard IAB track (ST 2098-2,
# "DTS:X for IAB"), which is this same --atmos path. There is no separate DTS:X UL.
dcpwizard create --title "My Film" --video ./j2k --audio ./audio.wav \
    --output ./dcp --atmos ./atmos.iab

# Closed captions (ST 429-12): an accessibility track with a MainClosedCaption
# CPL role, distinct from open --subtitle. Same input formats. Carried through
# every CPL path: single-reel, reel splitting, versions (a `ccap` manifest field),
# and VF (--add-ccap/--replace-ccap REEL=PATH).
dcpwizard create --title "My Film" --video movie.mov \
    --output ./dcp --ccap captions.srt --ccap-language en

# Accessibility channels: label sound channel 6 as HI and 7 as VI-N
dcpwizard create --title "My Film" --video ./j2k --audio ./8ch.wav \
    --output ./dcp --hi-channel 6 --vi-channel 7

# Audio processing at create time: route a directory of mono channel WAVs
# (name_L.wav, name_R.wav, ...), upmix stereo to 5.1, normalize loudness
dcpwizard create --title "My Film" --video movie.mov --output ./dcp \
    --audio ./channels --upmix a --loudness-target leqm=85 --true-peak-ceiling=-1.0

# Standalone audio tools: equal-power crossfade join, mid-side decode
dcpwizard crossfade --a first.wav --b second.wav -o joined.wav --overlap 1.0
dcpwizard mid-side-decode -i ms.wav -o lr.wav --mid 0 --side 1

# Encode QoL: start at a wall-clock time, resume after an interruption,
# power off when the encode finishes
dcpwizard create --title "My Film" --video movie.mov --output ./dcp \
    --start-at 22:00 --resume --shutdown-when-done

# Full pipeline: video → J2K → DCP in one pass (no intermediate files)
dcpwizard pipeline -i movie.mov -t "My Film" -o ./dcp --audio mix.wav

# Supplemental Version File (VF): replace reel 1's sound against an existing OV.
# Unchanged reels reference the OV by asset id; only the new MXF ships in the VF.
# Replacement can be raw essence (WAV/J2K, gets wrapped) or an already-wrapped MXF.
dcpwizard create-vf --ov ./dcp --output ./dcp_vf --replace-sound 1=./new_mix.wav
# Validate the VF against its OV (resolves cross-references):
dcpdoctor validate ./dcp_vf --ov ./dcp
# Subtitle VF: add or replace a reel's subtitle (SRT or SMPTE XML). A subtitle-only
# VF references the OV picture/sound by id and ships just the new subtitle MXF.
dcpwizard create-vf --ov ./dcp --output ./dcp_vf \
    --add-subtitle 1=./fr.srt --subtitle-language fr

# Assemble a new OV composition from existing DCPs (reels in program order)
dcpwizard assemble --input ./short_dcp --input ./feature_dcp \
    --output ./assembled --title "Short + Feature"

# Edit a DCP's CPL metadata in place (or into --output); refuses encrypted DCPs
dcpwizard edit --input ./dcp --title "My Film (2024 Restoration)" --content-kind FTR

# Multi-composition package: one CPL per manifest entry over a shared PKL/ASSETMAP
dcpwizard create-multi --compositions comps.json --output ./dcp
# comps.json:
#   [
#     { "title": "Ep 1", "j2k_dir": "./ep1/j2k", "audio": "./ep1/mix.wav" },
#     { "title": "Ep 2", "j2k_dir": "./ep2/j2k", "audio": "./ep2/mix.wav" }
#   ]

# Decrypt an encrypted DCP to cleartext (keys from a KDM + recipient key, or KEYS.json)
dcpwizard decrypt --input ./enc_dcp --output ./clear_dcp \
    --kdm kdm.xml --recipient-key recipient.key
dcpwizard decrypt --input ./enc_dcp --output ./clear_dcp --keys ./secret/my_film.keys.json

# Encode images to JPEG 2000
dcpwizard encode --input ./dpx --output ./j2k --bandwidth 250

# Transcode video to image sequence (format/bit-depth optional)
dcpwizard transcode --input movie.mov --output ./sequence --format dpx --bit-depth 16

# Export a DCP picture MXF to a delivery format (ProRes/H.264/H.265/DNxHR/image-sequence)
dcpwizard export --input picture.mxf --output out.mp4 --format h264 --audio sound.mxf

# Create DCDM (Digital Cinema Distribution Master)
dcpwizard dcdm -i ./frames -o ./dcdm --colour-space rec709

# Colour space conversion (rec709/p3/rec2020, or the DCDM transforms xyz and p3-d65)
dcpwizard colour -i ./rec709_frames -o ./p3_frames --source rec709 --target p3
dcpwizard colour -i ./rec709_frames -o ./p3d65_frames --source rec709 --target p3-d65

# Verify an existing DCP
dcpwizard verify ./my_dcp

# Verify with options (skip slow hash check, output report)
dcpwizard verify ./my_dcp --no-hash-check --output report.html

# Strict SMPTE Bv2.1 verification
dcpwizard verify ./my_dcp --strict --quiet

# Inspect DCP metadata
dcpwizard info ./my_dcp

# Generate KDM
dcpwizard kdm --cpl-id <uuid> --content-title "My Film" --cert recipient.pem \
    --signer-cert signer.pem --signer-key signer.key \
    --keys ./secret/my_film.keys.json --output kdm.xml

# KDM with validity period (--valid-to accepts a relative duration)
dcpwizard kdm --cpl-id <uuid> --content-title "My Film" --cert recipient.pem \
    --signer-cert signer.pem --signer-key signer.key --keys ./secret/my_film.keys.json \
    --output kdm.xml --valid-from now --valid-to "2 weeks"

# KDM with specific dates
dcpwizard kdm --cpl-id <uuid> --content-title "My Film" --cert recipient.pem \
    --signer-cert signer.pem --signer-key signer.key --keys ./secret/my_film.keys.json \
    --output kdm.xml --valid-from 2024-06-01T00:00:00+00:00 \
    --valid-to 2024-06-30T23:59:59+00:00

# KDM with a custom AnnotationText (default: "<title> KDM for <recipient>")
dcpwizard kdm --cpl-id <uuid> --content-title "My Film" --cert recipient.pem \
    --signer-cert signer.pem --signer-key signer.key --keys ./secret/my_film.keys.json \
    --output kdm.xml --annotation "My Film - Screen 1 - June run"

# Interop (legacy) KDM. --format defaults to smpte; interop uses the digicine
# ETM. Validate against real legacy gear before production use.
dcpwizard kdm --cpl-id <uuid> --content-title "My Film" --cert recipient.pem \
    --signer-cert signer.pem --signer-key signer.key --keys ./secret/my_film.keys.json \
    --output kdm.xml --format interop

# Copy to cinema drive
dcpwizard copy --src ./my_dcp --dst /mnt/cru_drive

# Format a delivery drive ext2/ext3 (refuses any mounted target; needs --yes)
dcpwizard format-drive /dev/sdb --fs ext3 --label MY_FILM --yes
# Check an existing drive's filesystem and label without touching it
dcpwizard check-drive /dev/sdb

# Measure audio loudness
dcpwizard loudness audio.wav

# Generate QC report
dcpwizard report --dcp ./my_dcp --output report.html

# Start REST API server
dcpwizard serve --bind 127.0.0.1:8080

# Watch folder for auto-DCP creation
dcpwizard watch ./incoming

# Job queue daemon
dcpwizard daemon

# Manage job queue
dcpwizard batch list
dcpwizard batch add -T create-dcp -p '{"title":"My Film","video":"./j2k","output":"./dcp"}'
dcpwizard batch cancel <job-id>

# Shell completion
dcpwizard completion bash >> ~/.bashrc
dcpwizard completion zsh >> ~/.zshrc
dcpwizard completion fish > ~/.config/fish/completions/dcpwizard.fish

# Convert SRT subtitles to SMPTE DCP XML
dcpwizard subtitle-convert --input subs.srt --output subs.xml --language en

# Subtitle track with placement, wrap, RTL and an embedded subset font.
# --subtitle accepts .srt/.ass/.pac/.mks/.mkv/.fcpxml/Interop-PNG or SMPTE DCST XML.
dcpwizard create --title "My Film" --video ./j2k --output ./dcp \
    --subtitle subs.ass --subtitle-language ar \
    --subtitle-halign center --subtitle-valign bottom --subtitle-vposition 8 \
    --subtitle-rtl auto --subtitle-wrap 42 --subtitle-font NotoSansArabic.ttf

# Edit a standalone subtitle file (any parsable format), written back as SRT
dcpwizard subtitle-edit --input subs.srt --list
dcpwizard subtitle-edit --input subs.srt --shift-ms -500 --output shifted.srt
dcpwizard subtitle-edit --input subs.srt --index 3 --text "Fixed line" \
    --set-start-ms 12000 --set-end-ms 14000 --output subs.srt

# Extract timed text from a DCP back to SRT (or .txt for text only)
dcpwizard subtitle-extract --input ./my_dcp --output subs.srt

# Burn subtitles into video
dcpwizard burn-in --input movie.mov --subtitles subs.srt --output movie_burned.mov

# Scale/crop video to DCI target resolution
dcpwizard convert --input movie.mov --output movie_2k_scope.mov --target 2k-scope
# Targets: 2k-scope (2048×858), 2k-flat (1998×1080), 2k-full (2048×1080),
#          4k-scope (4096×1716), 4k-flat (3996×2160), 4k-full (4096×2160)

# Conform an EDL/FCP7-XML timeline. Parse-only, or with --media-dir/--output
# resolve reels to media and build a finished multi-reel DCP (conform_plan.json
# and the conform manifest are kept as artifacts).
dcpwizard conform -i timeline.edl --json
dcpwizard conform -i timeline.edl --media-dir ./reels --output ./conform_out

# Camera raw ingest (--lut applies a 3D LUT during transcode)
dcpwizard ingest -s /mnt/camera_card -o ./dpx_frames -f dpx --colour-space ACES
dcpwizard ingest -s /mnt/camera_card -o ./dpx_frames --lut show.cube

# Extract a single frame from MXF/video
dcpwizard frame-extract -i video.mxf -f 100 -o frame100.png

# Inject Dolby Vision RPU into HEVC
dcpwizard dv-inject -i input.hevc -r metadata.bin -o output.hevc

# Inject HDR10 static metadata
dcpwizard hdr10-inject -i input.mov -o output.mov --max-cll 1000 --max-fall 400

# Burn a visible watermark into a video/image file
dcpwizard watermark -i movie.mov -o movie_wm.mov -p "DIST-001-SERIAL"

# Batch KDM: one KDM per recipient certificate in a single pass.
# List certs with repeated --cert, or point --cert-dir at a directory
# of cinema certs (every *.pem/*.crt/*.cer gets a KDM).
dcpwizard kdm-batch --cpl-id <uuid> --content-title "My Film" \
    --cert-dir ./cinema-certs \
    --signer-cert signer.pem --signer-key signer.key \
    --signer-chain intermediate.pem --signer-chain root.pem \
    --keys ./secret/my_film.keys.json --output-dir ./kdms

# ── KDM distribution ────────────────────────────────────────────────────────
# Cinema/screen database (default: ~/.local/share/dcpwizard/cinemas.json,
# override with --db). Screens hold a recipient cert; serial + thumbprint are
# cached for search. No private keys are ever stored.
dcpwizard cinema add --name "Odeon" --email ops@odeon.test --notes "priority"
dcpwizard cinema add-screen --cinema Odeon --name "Screen 1" --cert screen1.pem
dcpwizard cinema add-screen --cinema Odeon --name "Screen 2" --cert screen2.pem --inline
dcpwizard cinema list
dcpwizard cinema search 4ca4b493          # by name, or cert serial/thumbprint
dcpwizard cinema import-flm facility.xml  # import an FLM-x (SMPTE 430-7) file

# Named validity templates (default: ~/.local/share/dcpwizard/kdm-templates.json)
dcpwizard kdm-template add --name preshow --duration "1 week" --tz-offset "+02:00"
dcpwizard kdm-template add --name movie --start-offset "0 days" --duration "180 days"
dcpwizard kdm-template list
# use a template for the validity window (explicit --valid-from/--valid-to override)
dcpwizard kdm --cpl-id <uuid> --content-title "My Film" --cert screen1.pem \
    --signer-cert signer.pem --signer-key signer.key --template preshow --output kdm.xml

# Batch to whole cinemas / single screens from the db (--cert/--cert-dir still work)
dcpwizard kdm-batch --cpl-id <uuid> --content-title "My Film" \
    --cinema Odeon --screen "Rex/Screen 1" \
    --signer-cert signer.pem --signer-key signer.key --output-dir ./kdms

# Email the KDMs (one zipped email per cinema, dom#2516) using an SMTP config
# (see "KDM email config" below). --email-only-additional ignores cinema contacts.
dcpwizard kdm-batch --cpl-id <uuid> --content-title "My Film" --cinema Odeon \
    --signer-cert signer.pem --signer-key signer.key --output-dir ./kdms \
    --smtp-config ~/.config/dcpwizard/smtp.toml --email-to distributor@studio.test

# KDM generation history (default: ~/.local/share/dcpwizard/kdm-history.jsonl).
# Every successful kdm/kdm-batch appends a metadata record (never key material).
dcpwizard kdm-history --title "My Film" --since 2026-07

# Download a projector/server recipient cert by vendor + serial. Anonymous
# endpoints: dolby/doremi and qube. christie/gdc/barco need a vendor account
# (--user/--password; the password is never logged). Requires the `curl` binary.
dcpwizard cert-fetch --vendor dolby --serial 218281828 -o screen.pem
dcpwizard cert-fetch --vendor qube --type QXPD --serial 54 -o screen.pem
dcpwizard cert-fetch --vendor christie --serial 218281 --user me --password '***' -o screen.pem
dcpwizard cert-fetch --vendor barco --serial 1234567890 --user me --password '***' -o screen.pem

# Package a trailer (ratings card + countdown leader + content)
dcpwizard trailer -c trailer.mov -o ./trailer_pkg --title "My Film" \
    --rating "PG-13" --rating-system mpaa --band green --countdown 8

# Generate DCP markers for a composition
dcpwizard markers --frames 172800        # FFOC/LFOC list
dcpwizard markers --frames 172800 --xml  # XML MarkerList
# place any of the ten markers (frame number or HH:MM:SS:FF; validated <= length)
dcpwizard markers --frames 172800 --marker FFEC=01:59:00:00 --marker LFEC=02:00:00:00 --xml

# Check accessibility compliance
dcpwizard accessibility ./my_dcp --standard cvaa   # cvaa|eaa|aoda|ofcom

# Send a webhook notification
dcpwizard webhook --url https://example.com/hook --event job.completed \
    --job-id 42 --payload '{"status":"ok"}'

# Content version / delivery tracking (SQLite)
dcpwizard version record --db deliveries.db --package-uuid <uuid> \
    --title "My Film" --version OV --destination "AMC" --method hard_drive --verified
dcpwizard version list --db deliveries.db
dcpwizard version export --db deliveries.db --output deliveries.csv

# OV/VF version dashboard
dcpwizard dashboard register --uuid <uuid> --title "My Film" \
    --version-type OV --territory US --status released
dcpwizard dashboard list
dcpwizard dashboard matrix --output distribution.csv
dcpwizard dashboard serve --port 9090

KDM email config

kdm/kdm-batch --smtp-config points at a TOML file. It holds the SMTP password, so keep it outside the repo (e.g. ~/.config/dcpwizard/smtp.toml, mode 600). The password is never logged or echoed in errors.

key	required	notes
`host`	yes	SMTP server hostname
`port`	yes	e.g. 465 (tls) or 587 (starttls)
`security`	no	`tls` (default), `starttls`, or `none`
`username`	no	SMTP auth user
`password`	no	SMTP auth password
`from`	yes	sender address
`subject_template`	no	supports `{title}` and `{cinema}`
`body_template`	no	supports `{title}` and `{cinema}`

host = "smtp.example.com"
port = 587
security = "starttls"
username = "keys@studio.example"
password = "..."
from = "Studio Keys <keys@studio.example>"
subject_template = "KDMs for {title} — {cinema}"

With --cinema, one email per cinema is sent to its stored contact emails (plus any --email-to), each with that cinema's KDMs zipped. --email-only-additional sends only to --email-to.

REST API

Start the server:

dcpwizard serve --port 8080

Or via Docker:

docker run -p 8080:8080 -v /path/to/media:/data dcpwizard serve --port 8080

Comparison with easyDCP Creator+

Feature	DCP Wizard	easyDCP Creator+
SMPTE & Interop	✅	✅
Version Files (VF)	✅	✅
Multi-CPL timeline	✅ (`create --versions`)	✅
CLI scriptable	✅	✅
Up to 4K	✅	✅
Stereoscopic 3D	✅	✅
Frame rates 24–60 fps	✅	✅
High Bitrate (500 Mbps)	✅	✅
DPX/TIFF/PNG/QuickTime input	✅	✅
Scale/Crop/Letterbox	✅	✅
J2K Transcoder	✅	✅
Audio (PCM 5.1)	✅	✅
Immersive audio (Dolby Atmos)	✅	✅
MCA channel labeling (2.0/5.1/7.1 + HI/VI)	✅	✅
SRT→SMPTE subtitles	✅	✅
Subtitle packaging into DCP	✅	✅
Subtitle burn-in	✅	✅
Integrated QC	✅ (dcpdoctor)	✅ (Fraunhofer)
KDM (SMPTE + Interop)	✅	✅
AES-128 essence encryption	✅	✅
DKDM re-wrap	✅	✅
Desktop GUI	✅ (Tauri)	✅ (native)
REST API / Docker	✅	❌
Watch folder automation	✅	❌
Visible watermarking	✅	❌
DCDM intermediate format	✅	❌
Trailer packaging (ratings/leaders)	✅	❌
Content version tracking	✅	❌
Accessibility compliance (CVAA/EAA)	✅	❌
Dolby Vision / HDR10 / HLG	✅	❌
Camera format detection (ARRI/RED/BRAW)	✅	❌
Timeline conform (EDL/FCP7 XML)	✅	❌
Version dashboard & distribution matrix	✅	❌
Open source	✅ (AGPL-3.0)	❌
Price	Free	€2,998 or €138/mo

Architecture

dcpwizard/
├── rust/                # Rust workspace
│   ├── crates/
│   │   ├── dcpwizard-core/  # Core library, 59 modules, DCP creation, encoding, encryption, KDM, QC
│   │   └── dcpwizard-cli/   # CLI binary (dcpwizard)
│   └── Cargo.toml
├── gui/                 # Tauri 2 desktop application
│   ├── src/             # Frontend (Vite + vanilla JS)
│   └── src-tauri/       # Rust backend (plugin shell)
└── docs/                # GitHub Pages site

DCP Wizard shares common functionality with IMF Wizard via the postkit library (encoding, transcoding, hashing, job queue, preferences, REST API, watch folders, and more).

Name		Name	Last commit message	Last commit date
Latest commit History 200 Commits
.github/workflows		.github/workflows
debian		debian
docs		docs
extern		extern
gui		gui
rust		rust
scripts		scripts
tests		tests
.clang-format		.clang-format
.gitignore		.gitignore
.gitmodules		.gitmodules
CHANGELOG.md		CHANGELOG.md
DESIGN.md		DESIGN.md
DESIGN_TODO.md		DESIGN_TODO.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md

Navigation Menu

Uh oh!

Repository files navigation

DCP Wizard

Overview

Features

DCP Creation & Packaging

Encoding & Transcoding

Encryption & KDM

Subtitles & Captions

Audio

Quality Control

HDR & Dolby Vision

Camera Ingest

Export & Playback

Delivery & Automation

Mastering & Compliance

Installation

Pre-built binaries (recommended)

Install from source

Linux (Ubuntu/Debian)

macOS

Windows

Optional runtime dependencies

Docker

Desktop GUI

CLI Usage

KDM email config

REST API

Comparison with easyDCP Creator+

Architecture

License

About

Releases

Packages

Contributors

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

DCP Wizard

Overview

Features

DCP Creation & Packaging

Encoding & Transcoding

Encryption & KDM

Subtitles & Captions

Audio

Quality Control

HDR & Dolby Vision

Camera Ingest

Export & Playback

Delivery & Automation

Mastering & Compliance

Installation

Pre-built binaries (recommended)

Install from source

Linux (Ubuntu/Debian)

macOS

Windows

Optional runtime dependencies

Docker

Desktop GUI

CLI Usage

KDM email config

REST API

Comparison with easyDCP Creator+

Architecture

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages