Skip to main content

CLI utility to read/write XMP fields in files

Project description

https://travis-ci.org/gaqzi/py-xmp-tool.png?branch=master Latest Version Downloads

This is a simple command line utility to read/write single value fields in XMP files using the python-xmp-toolkit.

Installation

A simple install from pip:

$ pip install xmp-tool
Note: python-xmp-toolkit depends on Exempi which needs to be

built for XMP to be installed properly.

Use your systems package manager to install Exempi, on Mac OS X with homebrew:

$ brew install exempi

On a Debian based Linux system do:

# apt-get install libexempi-dev

Usage:

$ xmp-tool -h
usage: xmp-tool [-h] [--value VALUE] [--no-sidecar] [field] file [file ...]

Read or write XMP fields in a file

positional arguments:
  field          The field to read/write. If no field specified entire XMP
                 document printed.
  file           A file to work on

optional arguments:
  -h, --help     show this help message and exit
  --value VALUE  A value to write to the field specified
  --no-sidecar   Never write to sidecar files.

Reading a field:

$ xmp-tool format test.jpg
test.jpg: format=image/jpeg

Reading the entire XMP contents of a file:

$ xmp-tool test.jpg
test.jpg: None=<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>
<x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Exempi + XMP Core 5.1.2">
 <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
  <rdf:Description rdf:about=""
    xmlns:dc="http://purl.org/dc/elements/1.1/">
   <dc:PhysicalMedium>lto01</dc:PhysicalMedium>
  </rdf:Description>
 </rdf:RDF>
</x:xmpmeta>
<?xpacket end="w"?>

Writing a field:

# First try to read the field when there's no data in it
$ xmp-tool PhysicalMedium test.jpg
test.jpeg: ERROR READING FIELD "PhysicalMedium"

# Then try to add the data and then read the field
$ xmp-tool PhysicalMedium --value lto01 test.jpg
$ xmp-tool PhysicalMedium test.jpg
test.jpg: PhysicalMedium=lto01

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xmp-tool-0.9.2.tar.gz (4.3 kB view hashes)

Uploaded Source

Built Distribution

xmp_tool-0.9.2-py2.py3-none-any.whl (6.3 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page