Metadata¶

DuME can use metadata files to describe specific media files, especially After Effects projects, Blender scenes, etc. which aren’t actually media files.

These metadata files are JSON files which can be used with the CLI and other APIs.

Input file metadata¶

Only the file property is mandatory, all other fields are optional.

OCIO¶

DuME needs to know both the current color space of the input file, and the output color space (the LUT to be used to convert the colors to the output media).

By default, DuME sets the current color space for the file as it is defined in the current OCIO config file for this type of file (the default_byte (float pixel formats) or default_float (integer pixel formats) roles). This can be overriden by setting the OCIO_from_colorspace property.

To correctly convert the colors to the output space, both the OCIO_to_colorspace and a corresponding color_profile must be set to output the right colors. The color_profile tells DuME which standard color space to use for color interpretation after the OCIO conversion. It’s usually either "linear" or "sRGB" but could also be "bt709", "bt2020_10", "bt2020_12"…

Color profile¶

When used alone, color_profile just sets the color interpretation of the file, and may be omitted if it’s standard (i.e. "linear" for openEXR files, "srgb" for still images/sequences, "bt709" for HD video…).

Tip

Run DuME --color_profiles to list all available standard color profiles.

Framerate and duration¶

If the framerate is set but not the duration, DuME will automatically update any known duration to match the framerate override, if the framerate was known.

Full specs¶

{
    "file": "file_path",
    "duration": 0.0, // seconds
    "framerate": 0.0, // fps
    "OCIO_from_colorspace": "", // name of an OCIO input colorspace.
    "OCIO_to_colorspace": "", // name of an OCIO output colorspace
    "color_profile": "", // name of a DuME color profile
    "ae_rqitem": 1, // index of the After Effects render queue item to render
    "ae_comp": "", // name of the After Effects comp to render
    "ffmpeg_parameters": [ // Custom FFmpeg parameters to be applied when transcoding
        {
            "key": "",
            "value": ""
        }
    ]
}