dcp_inspect

dcp_inspect is a tool for deep inspection and validation of digital cinema packages (DCP, SMPTE and Interop). This includes integrity checks, asset inspection, schema validation, signature and certificate verification and composition summarization. Basically anyone who needs to establish the validity of a digital cinema package can put dcp_inspect to good use.

See the Examples page for some of the things it can do. Also see How to use Digital Cinema Tools' section for dcp_inspect.

Usage examples

    dcp_inspect --help
    dcp_inspect <path to directory>
    dcp_inspect <path to directory> --no-hash --no-audio-analysis
    dcp_inspect <path to directory> --nh --na
    dcp_inspect <path to directory> --as-asset-store --hash-limit <limit> --logfile <path>

Installation

See Digital Cinema Tools Distribution for an easy-to-use Setup script. This will install everything required.

Features

Will find and check all DCPs in a filesystem tree
Handles both Interop and SMPTE DCPs (and says useful things about free poetry DCPs, too)
Checks asset integrity
Checks timeline integrity of compositions
Checks applicable assets against XSD (XML Schema Definitions)
Checks and verifies signatures
Deep-inspects compositions

This includes composition type consistency and completeness checks.
Deep-inspects DCSubtitle
Reports in detail all errors encountered

See Examples. See What's missing.

Requirements

See Digital Cinema Tools Distribution for an easy-to-use Setup script. This will install everything required (batteries included). Run the setup occasionally to keep up-to-date.

If you prefer manual installation you will need the following:

Ruby
asdcplib and its cli tools
Nokogiri, a ruby wrapper for libxml2
dcp_inspect requires xsd/ next to it.

Clone the whole repository to put everything in place:
```
  $ git clone git://github.com/wolfgangw/backports.git
```

Run

$ git pull

in backports to keep up-to-date.

What's missing

Composition metadata (CMA)
Cross-check of updated naming convention with CMA / claimed asset properties / actual asset properties
Deep inspection of j2c markers/codestreams
Deep inspection of SMPTE timed text trackfiles
Better audio analysis wrt loudness
Assetmap options chunks, offsets, volume indices
Markers
Check Signer.X509IssuerSerial issuer name

Thank you

Thanks to Julik for his Timecode library (https://github.com/guerilla-di/timecode). Thanks to all the awesome people who tested, provided test materials, discussed and contributed. dcp_inspect wouldn't be a thing without you.

Runs on linux, macOS and windows (WSL) boxes.

Wolfgang Woehl 2011-2023

matmat / backports