Revision as of 16:40, 21 April 2021 by Prwheatley (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Clairmeta is a python package for Digital Cinema Package (DCP) probing and checking.
License:BSD 3-Clause "New" or "Revised" License
Platforms:Should work on Windows, macOS, Linux, Tested on : macOS 10.12


Clairmeta is a python package for Digital Cinema Package (DCP) probing and checking. This project status is Beta, the following needs to be done for the release :

  • Large scale tests on lots of DCPs (including D-Box, DVIs, OCAP, CCAP, ...)


  • DCP Probe : metadata extraction of the whole DCP, including all XML fields and MXF assets inspection.
  • DCP Checker : advanced DCP validation tool, including (non exhaustive):
    • SMPTE / Interop standard convention (naming, …)
    • Integrity (MIME type, size, hash) of all assets
    • Foreign file identification
    • XSD Schema validation for XML files (VOLINDEX, ASSETMAP, CPL, PKL)
    • Digital signature validation (CPL, PKL)
    • Intra / Inter Reels integrity and coherence
    • Metadata match between CPL assets and MXF headers
    • Re-link VF / OV
    • Picture tests : FrameRate, BitRate, …
    • Sound tests : Channels, Sampling, …
    • Subtitle : Deep inspection of Interop and SMPTE subtitles
  • DSM / DCDM Checker : basic image file sequence validation with some specific rules.


ClairMeta can be used as a general command line tool as well as a python library.

Examples for command line calls:

  python3 -m clairmeta.cli probe -type dcp path/to/dcp
  python3 -m clairmeta.cli probe -type dcp path/to/dcp -format json > dcp.json
  python3 -m clairmeta.cli probe -type dcp path/to/dcp -format xml > dcp.xml
  python3 -m clairmeta.cli check -type dcp path/to/dcp

Installation / Dependencies

Installation notes are available on the github page:


  • Python
    • Should work on python 2.7 and python 3.3+
    • Tested on : python 2.7, python 3.6
  • Platform
    • Should work on Windows, macOS, Linux
    • Tested on : macOS 10.12
  • External (non-python) dependencies :
    • libmagic
    • asdcplib
    • mediainfo (opt)
    • sox (opt)

User Experiences[edit]

Development Activity[edit]

All development activity is visible on GitHub:

Release Feed[edit]

Below the last 3 release feeds:

2024-02-06 21:09:27
[,2008:Repository/111405937/1.5.2 1.5.2]
by remia
2024-01-28 17:44:35
[,2008:Repository/111405937/1.5.1 1.5.1]
by remia
2023-08-25 20:49:33
[,2008:Repository/111405937/1.5.0 1.5.0]
by remia

Activity Feed[edit]

Below the last 5 commits:

2024-02-06 21:04:35
[,2008:Grit::Commit/1d4c9370d029e63b0da4d747322b7a13d5058957 Bump version]
by remia
2024-02-04 10:37:40
[,2008:Grit::Commit/d2d43351fd6df02c504f3c297d5f25a536f14894 Merge pull request #245 from remia/fix-cert-sign-date]
by remia
2024-02-03 11:11:21
[,2008:Grit::Commit/889757c9b047e6405fc75853040944461514d8a9 Add informative note for certificate expiration]
by remia
2024-02-01 21:16:21
[,2008:Grit::Commit/51498996f1e378e3f40bc391617f84c275870c21 Validate certificate date against the IssueDate instead of current time]
by remia
2024-01-28 17:35:19
[,2008:Grit::Commit/ece684c0ca0ccf1e90ae51c64b44cf0a80919444 Fix CI badge and workflow warnings]
by remia