A tool for manipulating production metadata, specifically tone map metadata (3D LUT), in MP4 and MOV files. It can be used to inject 3D LUT metadata into a file or validate metadata in an existing file.

Python 3.11 must be used to run the tool. From within the directory above lut3d_utils:

python lut3d_utils -h 

Prints help and usage information.

python lut3d_utils -inject_lut3d -i ${input_file} -o ${output_file} -l ${lut3d_file} -p COLOUR_PRIMARIES_BT709 -t COLOUR_TRANSFER_CHARACTERISTICS_GAMMA22 

Loads a tone mapping (3D LUT) metadata from lut3d_file and inject it to input_file(.mov or .mp4). The specified output_colour_primaries and output_colour_transfer_characteristics are injected too. It saves the result to output_file.
input_file and output_file must not be the same file.

python lut3d_utils -retrieve_lut3d -i ${input} -l ${lut3d_file} 

Checks if input_file contains 3D LUT metadata. If so, parses the metadata and prints it out. In addition, it saves the 3D LUT entries to lut3d_file as a ".cube" file.

pytest lut3d_utils/lut3d_util_test.py