Skip to main content

pyodr — Python bindings for OpenDocument.core

Decode office documents (ODF, OOXML, legacy MS binary, PDF, CSV, ...) and render them to HTML from Python.

import pyodr

file = pyodr.open("document.odt")
print(pyodr.file_type_to_string(file.file_type()))

service = pyodr.html.translate(file, pyodr.HtmlConfig())
html = service.bring_offline("output-dir")
for page in html.pages():
    print(page.name, page.path)

The pyodr <file> command renders a document and opens it in the browser. pyodr <file> --serve hosts it over HTTP. The server needs a build with ODR_WITH_HTTP_SERVER.

Building

The bindings are part of the main CMake build, toggled by ODR_PYTHON:

conan install . -o '&:with_python=True' --build missing
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake -DODR_PYTHON=ON
cmake --build build --target pyodr_core
PYTHONPATH=build/python python -m pytest python/tests

pip install . from the repository root builds a wheel with scikit-build-core (root pyproject.toml). Run conan install first and point CMAKE_ARGS at the generated toolchain file:

conan install . -o '&:with_python=True' --build missing
CMAKE_ARGS="-DCMAKE_TOOLCHAIN_FILE=$PWD/conan_toolchain.cmake" pip install .

Runtime data

There is none. The renderer's css and js are part of the library, and MIME detection needs no database. mimetype runs the open strategy, so it names what is inside a zip or a compound file.

Metadata

Release files for pyodr 7.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyodr 7.6.0
File Size Uploaded Provenance Actions
pyodr-7.6.0.tar.gz 1.9 MB With provenance Details for pyodr-7.6.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for pyodr 7.6.0
File Interpreter ABI Platform Actions
pyodr-7.6.0-cp314-cp314-manylinux_2_39_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.39+ x86-64 Details for pyodr-7.6.0-cp314-cp314-manylinux_2_39_x86_64.whl
pyodr-7.6.0-cp314-cp314-macosx_26_0_arm64.whl CPython 3.14 CPython 3.14 macOS 26.0+ ARM64 Details for pyodr-7.6.0-cp314-cp314-macosx_26_0_arm64.whl

Total release size: 9.6 MB

Release files / pyodr-7.6.0.tar.gz

Download URL pyodr-7.6.0.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
89d31a7429b8c851e0a632782e63d5a32d16d45a6ccfc32c4fca2dcd06132d3a
BLAKE2b-256 checksum
How to use checksums
3864e1d2bf0a7353c2a930f6e68f01840eb93c5cd940d3b1f33d71e3344a8614
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / pyodr-7.6.0-cp314-cp314-manylinux_2_39_x86_64.whl

Download URL pyodr-7.6.0-cp314-cp314-manylinux_2_39_x86_64.whl
Size 4.4 MB
Tags CPython 3.14 Linux glibc 2.39+ x86-64
SHA-256 checksum
How to use checksums
7bef2b97be960fa86fdd112851a10ba8332f9a74f4b53e6c1878a9eca2fc56b5
BLAKE2b-256 checksum
How to use checksums
ee09f7ff005035abaca602773b6f8cc6c4b01df5c1f6e04c858ace4194672a8d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / pyodr-7.6.0-cp314-cp314-macosx_26_0_arm64.whl

Download URL pyodr-7.6.0-cp314-cp314-macosx_26_0_arm64.whl
Size 3.2 MB
Tags CPython 3.14 macOS 26.0+ ARM64
SHA-256 checksum
How to use checksums
1d97bee2e34fd47135f5dba2fc0e1f16b0cd877e953fb6b1f7069a09d35ab437
BLAKE2b-256 checksum
How to use checksums
b2719edf03aebdc32d31b1bd7de41fdcaafdac1fa8b0ee57d600b52e33b133e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Security for pyodr 7.6.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 3 files in this release have been uploaded with provenance metadata.

Select from 3 files

Attestation for pyodr-7.6.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

7.6.0 This release

3 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page