Platforms

Platform support & build strategies (as of 07/2026)

Covered platforms

Platform	MinVer	Release [1]	Tier	PBIN	🐍	🧪	🛠️	SBLD	🧪	🛠️	CIBW	🧪	🛠️	⚙️	DEV	N
macOS arm64	🟡 13	✅🔄 PBIN	🟢 1	✅	✅	✅	⬜	✅	✅	🔲	✅	✅	⬜	clang	✅
macOS x86_64	🟡 13	✅🔄 PBIN	🔵 2	✅	✅	✅	🔳	✅	✅	🔲	✅	✅	🔲	clang	✅
macOS universal	🟡 13	🟦🔄 PBIN	🔵 2	✅	NA	✅	🔲	❌	NA	NA	❌	NA	NA	NA	NA
Windows x86_64	⚪ ?	✅🔄 PBIN	🟢 1	✅	✅	✅	⬜	✅	✅	⬜	✅	✅	⬜	clang	✅
Windows x86	⚪ ?	✅🔄 PBIN	🔵 2	✅	⏸️	✅	🔳	✅	✅	🔳	✅	✅	🔳	clang	NA
Windows arm64	⚪ 10?	✅🔄 PBIN	🔵 2	✅	✅	✅	🔳	✅	✅	🔲	✅	✅	🔲	clang	✅
Linux glibc x86_64	🟢 2.17	✅🔄 PBIN	🟢 1	✅	✅	✅	⬜	✅	✅	⬜	✅	✅	⬜	gcc	✅
Linux glibc i686	🟢 2.17	✅🔄 PBIN	🟢 1-2	✅	⏸️	☑️	🔳	✅	☑️	🔳	✅	☑️	⬜	gcc	✅
Linux glibc aarch64	🟢 2.17	✅🔄 PBIN	🟢 1	✅	✅	✅	🔳	✅	✅	🔲	✅	✅	⬜	gcc	✅
Linux glibc armv7l	🟢 2.17	✅🔄 PBIN	🟢 1-2	✅	⏸️	☑️	🔳	✅	☑️	🔳	✅	☑️	⬜	gcc	✅
Linux glibc ppc64le	🟢 2.17	✅🔄 PBIN	🔵 2-3	✅	✅	☑️	🔳	✅	☑️	🔳	✅	☑️	🔳	clang	☑️
Linux glibc s390x	🟡 2.28	✅📌 CIBW	🔴 4	❌	❌	NA	NA	❌	NA	NA	✅	☑️	🔳	clang	☑️
Linux glibc riscv64	🟠 2.34	✅📌 CIBW	🟡 3	❌	❌	NA	NA	❌	NA	NA	✅	☑️	🔳	clang	☑️
Linux glibc loong64	🔴 2.38	🟩📌 CIBW	🟡 3	❌	❌	NA	NA	❌	NA	NA	✅	☑️	🔳	clang	☑️
Linux glibc mips64le	🟢 2.17	🟩🔄 PBIN	🟡 3	✅	❓	☑️	🔳	✅	☑️	🔳	❌	NA	NA	NA	🅿️	[2]
Linux glibc mipsle	🟢 2.17	🟩📌 SBLD	🟡 3	✅	❓	❌	🔳	✅	❌	🔳	❌	NA	NA	NA	🅿️	[2] [3]
Linux musl x86_64	🟢 1.2	✅🔄 CIBW	🔵 2	✅	❓	✅	🔳	❌	NA	NA	✅	✅	⬜	gcc	✅
Linux musl i686	🟢 1.2	✅🔄 CIBW	🔵 2-3	✅	❓	☑️	🔳	❌	NA	NA	✅	☑️	⬜	gcc	✅
Linux musl aarch64	🟢 1.2	✅🔄 CIBW	🔵 2	✅	❓	✅	🔳	❌	NA	NA	✅	✅	⬜	gcc	✅
Linux musl armv7l	🟢 1.2	✅🔄 CIBW	🔵 2-3	❌	❌	NA	NA	❌	NA	NA	✅	☑️	⬜	gcc	✅
Linux musl ppc64le	🟢 1.2	✅📌 CIBW	🟡 3	❌	❌	NA	NA	❌	NA	NA	✅	☑️	🔳	clang	☑️
Linux musl s390x	🟢 1.2	✅📌 CIBW	🔴 4	❌	❌	NA	NA	❌	NA	NA	✅	☑️	🔳	clang	☑️
Linux musl riscv64	🟢 1.2	✅📌 CIBW	🟡 3	❌	❌	NA	NA	❌	NA	NA	✅	☑️	🔳	clang	☑️
Linux musl loong64	🟢 1.2	🟩📌 CIBW	🟡 3	❌	❌	NA	NA	❌	NA	NA	✅	☑️	🔳	clang	☑️
Android arm64	🔵 23	✅🔄 PBIN	🔵 2	✅	❓	❌	🔳	✅	❌	🔳	❌	NA	NA	NA	❌ [5]
Android armeabi	🔵 23	✅🔄 PBIN	🔵 2	✅	❓	❌	🔳	✅	❌	🔳	❌	NA	NA	NA	❌
Android x86_64	🔵 23	🟦🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	❌
Android x86	🔵 23	🟦🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	❌
iOS arm64 device	🔴 26	🟨🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	NA	[4]
iOS arm64 simulator	🔴 26	🟨🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	NA	[4]
iOS x86_64 simulator	🔴 26	🟨🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	NA	[4]
PyEmscripten wasm32	🟠 2026	❎📌 CIBW	🔴 4 (!)	❌ [6]	❌	NA	NA	❌	NA	NA	✅	☑️	🔳	emcc	NA	[7]

[1]

Since v5.12.0, build strategies used and platforms included may vary between releases. pypdfium2’s GitHub releases contain the authoritative strategy info, while this table currently reflects our default release profile.

[2] (1,2)

MIPS platforms are not officially part of the manylinux standard, so the wheel tags we use are actually rejected by pip, as they are not in its internal whitelist. This can be remedied by re-tagging with wheel locally to match the host’s sysconfig.get_platform() value. pip maintainers have been informed of this situation.

[3]

Untested, for lack of a container and binfmt handler.

[4] (1,2,3)

iOS is untested, and has special considerations regarding the management of binary extension modules. You should be prepared to patch the library search path in pypdfium2_raw/bindings.py. Pull requests to pypdfium2 and/or ctypesgen welcome.

[5]

Native compilation on Android (Termux) once worked in the past, with a rather early version of build_native.py and a pre-PEP738 interpreter, but this broke at some point, and it was eventually decided to remove the code passages. See here for historical instructions.

[6]

Though the pdfium-binaries project does provide WASM builds, they are actually incompatible with Pyodide/ctypes, which require a .so shared library side module, not a .wasm blob.

[7]

While there is experimental Pyodide build support, the resulting builds are known to be flaky at runtime and susceptible to various types of random crashes. Use with caution and not in a production environment! If you can help fix these issues, please reach out :)

Legend

• MinVer: Minimum required OS versions for present release. Other build strategies may result in different min versions, and older versions of pypdfium2/pdfium may have lower requirements.

  • 🟢 Low/Good, 🔵 Reasonable, 🟡 Medium, 🟠 Elevated, 🔴 High, ⚪ Not tagged

• Release:

  • Status:

    • ✅ Wheels on PyPI & GH

    • 🟩 GH only - Rejected by PyPI (not whitelisted in backend)

    • ❎ GH only - Intentionally not uploaded to PyPI (known issues or other unsuitability)

    • 🟦 Setup only

    • 🟨 Setup only (unresolved issues)

  • Version tracked: 🔄 Latest / 📌 Pinned

  • Strategy: see below

• Tier: Platform support level

  • 🟢 1 Core, 🔵 2 Secondary, 🟡 3 Complicated, 🔴 4 Major issues, ⚪ Not classified

• Strategies

  • PBIN = Repack external builds from bblanchon/pdfium-binaries.

  • SBLD = Built at pypdfium2 via sbuild.yaml (build_toolchained.py).

  • CIBW = Built at pypdfium2 via cibw.yaml (build_native.py + containers on Linux, build_toolchained.py on Windows and macOS).

  • ✅ Platform supported, ❌ Not supported with that strategy, ⏳In planning

• 🐍 Conda (PBIN only)

  • ✅ Released to conda

  • ⏸️ Built, but conda upload is paused due to storage limits. Get in touch with pdfium-binaries if you would like this to be reinstated.

  • ❓ Built, but unclear if there were any point releasing this to conda (not a priority)

  • ❌ Not built at pdfium-binaries

• 🧪 Testing status

  • ✅ Tested on host

  • ☑️ Tested under emulation

  • ❌ Not automatically tested

• 🛠️ Cross compilation indicator

  • ⬜ Native compilation

  • 🔳 Cross compilation

  • 🔲 Both is possible / applies

• ⚙️ Compiler used (CIBW only – PBIN and SBLD always use clang)

• DEV: Can be built from source natively on-device?

  • ✅ Yes (tested with GHA)

  • ☑️ Yes (tested with Docker)

  • 🅿️ Probably (might need minor tweaks)

• N: Notes

• Common identifiers

  • NA Not applicable / unknown (placeholder)

  • 👷 Work in progress

  • 🚧 This used to work in the past, but is currently broken

Help wanted

Reckon you can turn more ❌ into ✅ ? Please give it a try and open a PR.

Other platforms

Platform	Status	Comment
FreeBSD	🟦	Fallback installation with libreoffice-pdfium should work, and we occasionally test it on CI. Note, however, that libreoffice-pdfium tends to be a bit incomplete. Building from source might work with a feasible amount of patching. It may be possible to provide prebuilds for x86_64 in the future. There is also upstream work in progress to have PDFium added to the ports collection.
OpenBSD / *BSD	❓	Libreoffice is not built with PDFium on OpenBSD. However, if building on FreeBSD is possible, it may be doable on other BSDs, too.
Illumos	❌	No known prebuilds available. PDFium has not been ported to this platform.
Haiku	❌	No known prebuilds available. PDFium has not been ported to this platform.
SerenityOS	❌	No known prebuilds available. PDFium has not been ported to this platform.
AIX	❓	No known prebuilds available. Proprietary OS. Chromium build infrastructure appears to have some degree of support for AIX but the exact status is unknown.
z/OS	❌	No known prebuilds available. PDFium has not been ported to this platform. Proprietary OS.