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	✅	[2]
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	🅿️	[3]
Linux glibc mipsle	🟢 2.17	🟩📌 SBLD	🟡 3	✅	❓	NA	NA	✅	❌	🔳	❌	NA	NA	NA	🅿️	[3] [4]
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	🚧
Android armeabi	🔵 23	✅🔄 PBIN	🔵 2	✅	❓	❌	🔳	✅	❌	🔳	❌	NA	NA	NA	NA
Android x86_64	🔵 23	🟦🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	NA
Android x86	🔵 23	🟦🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	NA
iOS arm64 device	🔴 26	🟨🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	NA	[5]
iOS arm64 simulator	🔴 26	🟨🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	NA	[5]
iOS x86_64 simulator	🔴 26	🟨🔄 PBIN	⚪ nan	✅	❓	❌	🔳	❌	NA	NA	❌	NA	NA	NA	NA	[5]

[1]

Since v5.12.0, build strategies used and platforms included may vary between releases. While we endeavor to keep this table up-to-date with the current release on a best effort basis, the authoritative resource is the release itself.

[2]

Testing is temporarily disabled, due to issues with the Docker container when called from GHA. It does work locally. To be investigated.

[3] (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.

[4]

Untested, for lack of a container and binfmt handler.

[5] (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.

Legend

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

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

• Release: status, version tracked, build strategy

  • ✅ Wheels on PyPI/GH, 🟩 Wheels on GH only [6], 🟦 Setup only, 🟨 dto. (open issues)

  • 🔄 Latest version, 📌 Pinned version

• Tier: Platform support level

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

• Build 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)

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

[6]

Some platforms (LoongArch, MIPS) are rejected by PyPI, as they are not whitelisted in its backend (warehouse).

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.