Skip to main content

Pypi latest version Python Support License: BSD 3 Clause Documentation Status

build status GitHub last commit issues closed PRs closed

linters: ruff, mypy Pull Requests Welcome first-timers-only Friendly

pdfly

pdfly (say: PDF-li) is a pure-python cli application for manipulating PDF files.

pdfly logo

Installation

pip install -U pdfly

As pdfly is an application, you might want to install it with pipx or uv tool: uvx pdfly --help

Usage

$ pdfly --help

 Usage: pdfly [OPTIONS] COMMAND [ARGS]...

 pdfly is a pure-python cli application for manipulating PDF files.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --version        <bool>                                                                          │
│ --help           <bool>  Show this message and exit.                                             │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
│ 2-up                     Put each pair of pages side by side on one page.                        │
│ booklet                  Reorder and two-up PDF pages for booklet printing.                      │
│ cat                      Concatenate pages from PDF files into a single PDF file.                │
│ check-sign               Verifies the signature of a signed PDF.                                 │
│ compress                 Compress a PDF.                                                         │
│ extract-annotated-pages  Extract only the annotated pages from a PDF.                            │
│ extract-images           Extract images from PDF without resampling or altering.                 │
│ extract-links            Extract all links from a PDF document.                                  │
│ extract-text             Extract text from a PDF file.                                           │
│ meta                     Show metadata of a PDF file                                             │
│ pagemeta                 Give details about a single page.                                       │
│ rm                       Remove pages from PDF files.                                            │
│ rotate                   Rotate specified pages by the specified amount                          │
│ sign                     Creates a signed PDF from an existing PDF file.                         │
│ decrypt                  Remove password protection from an encrypted PDF file.                  │
│ uncompress               Uncompress the page content streams of a PDF.                           │
│ update-offsets           Updates offsets and lengths in a simple PDF file.                       │
│ x2pdf                    Convert one or more files to PDF. Each file is a page.                  │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

You can see the help of every subcommand by typing --help:

$ pdfly 2-up --help

 Usage: pdfly 2-up [OPTIONS] {pdf} {out}

 Put each pair of pages side by side on one page.

 Pages 1 and 2 become the left and right half of the first output page,
 pages 3 and 4 the left and right half of the second one, and so on.
 If the number of pages is odd, the right half of the last output page
 stays blank. The page order is not changed; use `pdfly booklet` to
 reorder the pages for booklet printing.

 Example:
     pdfly 2-up input.pdf output.pdf

╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    pdf      <file>  [required]                                             │
│ *    out      <path>  [required]                                             │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help        <bool>  Show this message and exit.                            │
╰──────────────────────────────────────────────────────────────────────────────╯

Note: pdfly has nothing to do with pdfly.net or gopdfly.com

Contributors ✨

pdfly is a free software project without any company affiliation. We cannot pay contributors, but we do value their contributions 🤗

Martin Thoma
Martin Thoma

💻 📖 🤔 🚇 🚧 📆 ✅
Lucas Cimon
Lucas Cimon

🐛 💻 📖 🚧
Rob Adams
Rob Adams

💻
Harsh
Harsh

💻
Sascha Rogmann
Sascha Rogmann

💻
Enrique Botía
Enrique Botía

💻
kommade
kommade

💻
Zingzy
Zingzy

💻
Subhajit Sahu
Subhajit Sahu

💻
Kian-Meng Ang
Kian-Meng Ang

🤔
Hal Wine
Hal Wine

🐛 💻
philippesamuel
philippesamuel

📖
marcobrb
marcobrb

📖
moormaster
moormaster

📖 💻
Geoff Beier
Geoff Beier

💻
Yuriy Chernyshov
Yuriy Chernyshov

🤔 💻
lkintact
lkintact

🐛

This project follows the all-contributors specification (emoji key). Contributions of any kind welcome!

The list might not be complete. You can find more contributors via the git history and GitHubs 'Contributors' feature.

Metadata

Release files for pdfly 0.7.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 pdfly 0.7.0
File Size Uploaded Provenance Actions
pdfly-0.7.0.tar.gz 29.1 kB With provenance Details for pdfly-0.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pdfly 0.7.0
File Interpreter ABI Platform Actions
pdfly-0.7.0-py3-none-any.whl Python 3 none any Details for pdfly-0.7.0-py3-none-any.whl

Total release size: 60.9 kB

Release files / pdfly-0.7.0.tar.gz

Download URL pdfly-0.7.0.tar.gz
Size 29.1 kB
Tags Source
SHA-256 checksum
How to use checksums
10b2562ab76f0f9ed4977676c2c25069b8bc726db2bbcb17f31cd3ac62126997
BLAKE2b-256 checksum
How to use checksums
84ab62fa07b7ba6cf2e4a1a89f31df690277939b17cba54a8c17a89ad578fe48
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 15, 2026.

Transparency log

Release files / pdfly-0.7.0-py3-none-any.whl

Download URL pdfly-0.7.0-py3-none-any.whl
Size 31.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
88ea469c208d00656977b0f56c42396eacb7b8b4a8fbb417b224c1417deb2ffa
BLAKE2b-256 checksum
How to use checksums
fab98404a445df45b13509bddac65a872c6a81743e1950358e1e69a6e78e4cdb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 15, 2026.

Transparency log

Security for pdfly 0.7.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

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for pdfly-0.7.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 Nov 15, 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.

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