ClairMeta

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:

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

2024-02-06 21:09:27

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

by remia

Activity Feed

Below the last 5 commits:

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

2025-09-27 13:09:38

[tag:github.com,2008:Grit::Commit/7c83a63809263024c50c65d656d6e13fd922357d Fix asdcplib build with CMake 4]

by remia https://github.com/remia

2025-09-27 13:03:09

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

by remia https://github.com/remia

2025-09-27 13:03:00

[tag:github.com,2008:Grit::Commit/b89cdaba0e173a34309eeb5adb92cdf63fe6a919 Update PyPI publish workflow]

by remia https://github.com/remia

2025-09-27 13:02:47

[tag:github.com,2008:Grit::Commit/cf7c6f182b215d41fc7cfc69fba38a0b956adbe3 Improve error message]

by remia https://github.com/remia