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-10-10 08:58:30

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

by remia

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

Activity Feed

Below the last 5 commits:

2026-10-10 08:42:54

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

by remia https://github.com/remia

2026-10-09 19:43:06

[tag:github.com,2008:Grit::Commit/d6d109f1a284be588503142c05eba9d305b93b08 Merge pull request #269 from remia/prepare-release]

by remia https://github.com/remia

2026-10-04 14:52:35

[tag:github.com,2008:Grit::Commit/6bde257e3f1cdcab8b6c77e23864d3fe3f579e93 Add subvoyant to contributors]

by remia https://github.com/remia

2026-10-04 14:52:08

[tag:github.com,2008:Grit::Commit/805ee8cf98f56ad7ec354146662420bf86864919 Use absolute path when running asdcp-unwrap]

by remia https://github.com/remia

2026-10-04 14:51:43

[tag:github.com,2008:Grit::Commit/88ab053cc8428b83dcd0e700c01800a6123777ad Fix ruff errors]

by remia https://github.com/remia