Python API and tools to manipulate OpenDocument files

pip install odfpy==1.4.1



This is a collection of utility programs written in Python to manipulate OpenDocument 1.2 files.

How to proceed: Each application has its own directory. In there, look at the manual pages. The Python-based tools need the odf library. Just make a symbolic link like this: ln -s ../odf odf ... or type: make

For your own use of the odf library, see api-for-odfpy.odt


First you get the package.

$ git clone

Then you can build and install the library for Python2 and Python3:

$ python build
$ python3 build
$ su
# python install
# python3 install

The library is incompatible with PyXML.


Install tox via pip when running the tests for the first time:

$ pip install tox

Run the tests for all supported python versions:

$ tox


This project, with the exception of the OpenDocument schemas, are Copyright (C) 2006-2014, Daniel Carrera, Alex Hudson, Søren Roug, Thomas Zander, Roman Fordinal, Michael Howitz and Georges Khaznadar.

It is distributed under both GNU General Public License v.2 or (at your option) any later version or APACHE License v.2. See GPL-LICENSE-2.txt and APACHE-LICENSE-2.0.txt.

The OpenDocument RelaxNG Schemas are Copyright © OASIS Open 2005. See the schema files for their copyright notice.

This program 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.