+1
Daily
5,589
stars
419
forks
75
watchers
868
prs
835
issues
64
releases
README
qpdf is a command-line tool and C++ library that performs content-preserving transformations on PDF files. It supports linearization, encryption, and numerous other features. It can also be used for splitting and merging files, creating PDF files (but you have to supply all the content yourself), and inspecting files for study or analysis. qpdf does not render PDFs or perform text extraction, and it does not contain higher-level interfaces for working with page contents. It is a low-level tool for working with the structure of PDF files and can be a valuable tool for anyone who wants to do programmatic or command-line-based manipulation of PDF files. The qpdf manual is hosted online at https://qpdf.readthedocs.io. The project website is https://qpdf.sourceforge.io. The source code repository is hosted at GitHub: https://github.com/qpdf/qpdf. macOS Binaries Starting with version 12.4.2, macOS binaries are available for download in the releases area. These are not signed with an Apple Developer ID or notarized, so you will have to remove the quarantine attribute that macOS adds to downloaded files. The easiest way to do this is to run this in the directory where you unzipped the Mac binaries: xattr -r -d com.apple.quarantine bin lib Verifying Distributions Official qpdf releases are signed using cosign. Each release includes a sha256 file containing sha256 checksums of all the release files. To verify a release, use sha256sum file, or similar, to generate the checksum of the file you want to verify and check to make sure it matches what's in the sha256 file. You can verify the sha256 file itself with gpg or with cosign verify-blob. Example: cosign verify-blob qpdf-x.y.z.sha256 --bundle qpdf-x.y.z.sha256.sigstore \ [email protected] \ --certificate-oidc-issuer=https://github.com/login/oauth The identity [email protected] should be replaced with the name of the person who signed the release. This will be indicated in the release notes. Valid signers are Jay Berkenbilt Manfred Holger You can also verify qpdf releases using Jay Berkenbilt's GPG key, which has fingerprint C2C9 6B10 011F E009 E6D1 DF82 8A75 D109 9801 2C7E and can be found at https://q.ql.org/pubkey.asc or downloaded from a public key server. Copyright, License qpdf is copyright (c) 2005-2021 Jay Berkenbilt, 2022-2026 Jay Berkenbilt and Manfred Holger Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an " AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. You may also see the license in the file LICENSE.txt in th
Top issues
#1003split with hyperlinks22 comments · 2023-07-07#343[Feature request] Create/edit outline of PDF16 comments · 2019-07-04#490Support for merging tagged PDFs12 comments · 2020-12-16#477auto-split on bookmarks?12 comments · 2020-10-20#9Feature Request: join pages while maintaining layers12 comments · 2013-04-29#1427Add MbedTLS crypto provider11 comments · 2025-04-10#448Option to remove duplicated streams11 comments · 2020-06-18#94preserve hyperlinks11 comments · 2016-12-16
Discussions
#1761Add code signing for Windows0 comments · 2026-08-18#1751QuickPDF 1.01 comments · 2026-08-10#1722Trim whitespace from around a PDF using Qpdf & AI?3 comments · 2026-05-13#1710Advanced "micro-manipulations" of .pdf files?0 comments · 2026-05-02#1697Add-on plugin for qpdf, to as many pdf-related software as possible1 comments · 2026-04-15#1687Apply inspection mode per PDF?4 comments · 2026-04-03#1664Use qpdf with options ?1 comments · 2026-01-29#1627Return number of pages in a pdf1 comments · 2025-12-10
Latest release
qpdf version 12.4.2 v12.4.2 2026-09-27This is qpdf version 12.4.2. In addition to a few small bug fixes, this release features two significant improvements: inclusion of several new binary platform releases and substantial improvements to linearization. We now include official release binaries for MacOS (intel and arm64), Windows arm64, and Linux aarch64 (arm64) both as an AppImage and as stand-alone binaries. For linearization, for certain types of files, qpdf is vastly more memory efficient (we've seen 30× improvements in some cases) and slightly faster. Also, there are a few small fixes to linearization object ordering, so line