ClairMeta

Clairmeta is a python package for Digital Cinema Package (DCP) probing and checking.
Homepage:	https://github.com/Ymagis/ClairMeta
License:	BSD 3-Clause "New" or "Revised" License
Platforms:	Should work on Windows, macOS, Linux, Tested on : macOS 10.12

Description

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, ...)

Features

• 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.

Usage

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: https://github.com/Ymagis/ClairMeta

Dependencies:

• 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)

Development Activity

All development activity is visible on GitHub: https://github.com/Ymagis/ClairMeta/commits/develop

Release Feed

Below the last 3 release feeds:

2026-07-14 17:17:44

[tag:github.com,2008:Repository/111405937/1.6.2 1.6.2]

by remia

2025-09-27 13:32:29

[tag:github.com,2008:Repository/111405937/1.6.1 1.6.1]

by remia

2025-03-15 10:10:39

[tag:github.com,2008:Repository/111405937/1.6.0 1.6.0]

by remia

Activity Feed

Below the last 5 commits:

2026-07-14 17:09:47

[tag:github.com,2008:Grit::Commit/0e72d174690d0d09b92712df1c55fa492b23c540 Bump version]

by remia https://github.com/remia

2026-07-14 17:07:41

[tag:github.com,2008:Grit::Commit/e010651351026a68abd4a3fd23a7eff64177dabb Merge pull request #261 from remia/fix-missing-xsd]

by remia https://github.com/remia

2026-06-30 19:44:32

[tag:github.com,2008:Grit::Commit/838cf305b6c9e44f13090482ef62092fef29587e Update to GHA workflows]

by remia https://github.com/remia

2026-06-30 18:44:51

[tag:github.com,2008:Grit::Commit/b33ef5567a0ca1b6d55db11cc2fd43498726df11 Fix missing XSD files in the wheel]

by remia https://github.com/remia

2025-09-27 13:15:44

[tag:github.com,2008:Grit::Commit/06f32f072f28e78994d34f6457bf1840cfb6768c Merge pull request #259 from remia/bump-version]

by remia https://github.com/remia