py3exiv2
*******

Welcome to py3exiv2, a python 3 binding to exiv2 (http://exiv2.org/), the C++
library for manipulation of EXIF, IPTC and XMP image metadata.
It is a python 3 module that allows your python scripts to read and write
metadata (EXIF, IPTC, XMP, thumbnails) embedded in image files
(JPEG, TIFF, ...).

Point your browser to http://exiv2.org/metadata.html for the complete metadata
tag reference.


Build dependencies
==================

py3exiv2 depends on the following libraries:

 * python (≥ 3.3)
 * boost.python3 (http://www.boost.org/libs/python/doc/index.html)
 * exiv2 (http://www.exiv2.org/)

Some examples in src/ use PyGTK (http://www.pygtk.org/) and PyQt
(http://www.riverbankcomputing.co.uk/software/pyqt/) to display image previews,
those are optional dependencies.

This is a typical list of build dependencies for a Debian/Ubuntu system:

 * python-all-dev (≥ 3.3)
 * libexiv2-dev (≥ 0.20)
 * libboost-python-dev (≥ 1.48)
 * g++


Building and installing
=======================

py3exiv2 can be built and installed using ``setup.py`` as usual.

To use py3exiv2 in your scripts, simply import the pyexiv2 module.

Note: the lib name is py3exiv2 but, for compatibility, the top-level
module is named pyexiv2.


Documentation
=============

You can find the API documentation at:
    http://python3-exiv2.readthedocs.org/en/latest
or refer to the internal documentation for a guide on how to use py3exiv2.
In a python interpreter, type:

 >>> import pyexiv2
 >>> help(pyexiv2)


License
=======

Copyright (C) 2006-2012 Olivier Tilloy <olivier@tilloy.net>
Copyright (C) 2015-2019 Vincent Vande Vyvre <vincent.vandevyvre@oqapy.eu>
Copyright (C) 2019      Zack Weinberg <zackw@panix.com>

py3exiv2 is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License version 3 as published by the Free
Software Foundation.

py3exiv2 is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with py3exiv2.  If not, see <https://www.gnu.org/licenses/>.


Developers
==========

py3exiv2 is Free Software, meaning that you are encouraged to play with it,
modify it to suit your needs and contribute back your changes and bug fixes.

The bug tracking system and the main bazaar branch are hosted at Launchpad:

 https://launchpad.net/py3exiv2

To get a working copy of the latest version of the code, you need to have bazaar
(http://bazaar.canonical.com/) installed:

 $ bzr branch lp:py3exiv2

Feedback, bug reports and patches are welcome!