Package: cgmetadata
CGMetadataRead and write image metadata on macOS from Python using the nativeImageIO / Core Graphics frameworks.CGMetadata is a Python wrapper around the macOS ImageIO and Core Graphics frameworks. It provides a simple interface for reading and writing image metadata, including EXIF, IPTC, and XMP data. Reading is supported for all image formats supported by ImageIO.Writing is not currently supported for RAW file formats.  Writing of metadata has been tested on JPEG, PNG, TIFF, and HEIC files however it should be considered experimental. If you are using CGMetadata to write metadata to image files, please make sure you have tested the results before using it in production.Video formats are not currently supported.Synopsis>>>fromcgmetadataimportImageMetadata,IPTC,XMP>>>md=ImageMetadata("test.jpeg")>>>md.exif["LensMake"]'Apple'>>>md.iptc["Keywords"]['fruit', 'tree']>>>md.xmp["dc:description"]['A pair of pears on a tree']>>># get XMP sidecar as a str>>>xmp=md.xmp_dumps()>>># write an XMP sidecar file for the image>>>withopen("test.xmp","w")asf:...md.xmp_dump(f)...>>># read metadata from  XMP sidecar file and apply to image>>>withopen("test.xmp","r")asf:...md.xmp_load(f)...>>>>>>md.write()>>># set metadata>>>md.set(XMP,"dc:description",["Test image"])>>>md.set(IPTC,"Keywords",["foo","bar"])>>>md.write()>>>md.xmp["dc:description"]['Test image']>>>md.iptc["Keywords"]['foo', 'bar']>>>>>># update values with context manager>>>withImageMetadata("test.jpeg")asmd:...md.set(IPTC,"Keywords",["Fizz","Buzz"])...md.set(XMP,"dc:creator",["CGMetadata"])...>>>md.iptc["Keywords"]['Fizz', 'Buzz']>>>InstallationpipinstallcgmetadataDocumentationThe documentation for CGMetadata is available athttps://RhetTbull.github.io/CGMetadata/.Source CodeThe source code for this project is available onGitHub.Command Line InterfaceThe package will install a small command line interface (CLI),cgmd, which prints
metadata for an image file in tabular, JSON, CSV, TSV, or XMP formats. The CLI can also
be run by executingpython3 -m cgmetadata.usage: cgmd [-h] [--version] [--csv] [--tsv] [--json] [--xmp] [--indent INDENT] [--no-header] IMAGE

Print metadata for image files in various formats.

positional arguments:
  IMAGE                 path to image file

options:
  -h, --help            show this help message and exit
  --version, -v         show program's version number and exit
  --csv, -c             output as comma separated values (CSV); see also --no-header
  --tsv, -t             output as tab separated values (TSV); see also --no-header
  --json, -j            output as JSON; see also --indent
  --xmp, -x             output XMP sidecar for image; see also --no-header
  --indent INDENT, -i INDENT
                        indent level for JSON; default 4, use 0 for no indentation
  --no-header, -H       when used with --csv, --tsv, omit column headers; when used with --xmp, omit XMP packet headerSupported VersionsCGMetadata has been tested on macOS 13 (Ventura) but should work on macOS 11 (Big Sur) and later. It will not work on earlier versions of macOS due to the use of certain APIs that were introduced in macOS 11. It is compatible with Python 3.9 and later.LicenseMIT License, copyright Rhet Turnbull, 2023.