Difference between revisions of "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

Latest revision as of 16:40, 21 April 2021

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)

User Experiences

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

@@ Line 1: / Line 1: @@
-<!-- Use the structure provided in this template, do not change it! -->
+{{Infobox tool
+|purpose=Clairmeta is a python package for Digital Cinema Package (DCP) probing and checking.
-{{Infobox_tool
-|purpose=Clairmeta is a python package for Digital Cinema Package (DCP) probing and checking.
-|image={{PAGENAMEE}}.png
 |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
 }}
-<!-- Note that to use the image field, you should leave the value as {{PAGENAMEE}}.png (or similar) and upload a copy of the image. Hot-linking is not supported. If you don't want an image, just remove that line. -->
+{{Infobox tool details}}
-<!-- Add one or more categories to describe the function of the tool, such as:
-[[Category:Metadata Extraction]] or [[Category:Preservation System]] or [[Category:Backup]]
-Choose carefully, and view the list of existing categories first (see the Navigation sidebar on the left) -->
-<!-- Add relevant categories to describe the content type that the tool addresses, such as:
-[[Category:Audio]] or [[Category:Document]] or [[Category:Research Data]]
-Choose carefully, and view the list of existing categories first (see the Navigation sidebar on the left). If the tool works on any content type, do not add a category. -->
 == Description ==
 <!-- Describe the what the tool does, focusing on it's digital preservation value. Keep it factual. -->
@@ Line 92: / Line 77: @@
 <!-- Add the OpenHub.com ID for the tool, if known. -->
-{{Infobox_tool_details
-|releases_rss=
-|issues_rss=
-|mailing_lists=
-|ohloh_id=
-}}