最新版本 v1.0.8 · MIT 开源协议

一行代码
搞定 PDF 自动化

popdf 是 Python 自动化办公的 PDF 操作库,支持转换、分割、合并、加密、水印等,简单到零基础也能用。

9
核心功能
1.0.8
最新版本
MIT
开源协议
≥3.7
Python 版本

9 大核心功能

单文件处理 or 批量处理,一个参数切换模式

📝

PDF 转 Word

将 PDF 文档转换为可编辑的 Word 文件,保留排版格式

popdf.pdf2docx(input_file='a.pdf', output_file='b.docx')
🖼️

PDF 转图片

将 PDF 页面导出为高清图片,支持合并为单张

popdf.pdf2imgs(input_file='a.pdf', output_path='./imgs/')
📄

TXT 转 PDF

将纯文本文件一键转为 PDF 文档

popdf.txt2pdf(input_file='readme.txt', output_file='readme.pdf')
✂️

PDF 分割

按页码范围精准截取,提取你需要的部分

popdf.split4pdf(input_file='a.pdf', from_page=1, to_page=5)
🔒

PDF 加密

为 PDF 添加密码保护,支持单文件和批量加密

popdf.encrypt4pdf(password='pwd', input_file='a.pdf')
🔓

PDF 解密

移除 PDF 密码保护,恢复自由访问

popdf.decrypt4pdf(input_file='a.pdf', password='pwd')
💧

添加水印

自定义文本水印,灵活控制位置、字号、颜色

popdf.add_text_watermark(input_file='a.pdf', point=(100,100), text='机密')
🧩

PDF 合并

将多个 PDF 文件合并为一个完整的文档

popdf.merge2pdf(input_file_list=['a.pdf','b.pdf'], output_file='c.pdf')
🗑️

删除页面

按页码删除不需要的页面,精简你的文档

popdf.del4pdf(page_nums=[2,4], input_file='a.pdf')

📦 安装

一行命令,即刻开始

# pip 安装(推荐使用阿里云镜像)
pip install -i https://mirrors.aliyun.com/pypi/simple/ popdf -U
源码安装
git clone + pip install -e .
Python ≥ 3.7
支持 Windows / macOS / Linux
CLI 命令行
安装后直接使用 popdf 命令

⚡ 快速开始

3 行代码体验 PDF 转换

import popdf

# PDF 转 Word
popdf.pdf2docx(input_file='report.pdf', output_file='report.docx')

# PDF 加密
popdf.encrypt4pdf(password='123456', input_file='secret.pdf')

# PDF 加水印
popdf.add_text_watermark(input_file='doc.pdf', point=(200, 300), text='机密文件')
import popdf

# 批量 PDF 转 Word — 整个目录一键处理
popdf.pdf2docx(input_path='/home/pdf/', output_path='/home/docx/')

# 批量加密 — 所有 PDF 统一加密码
popdf.encrypt4pdf(password='pwd', input_path='./input/', output_path='./output/')
# 命令行方式调用 — 无需写 Python 代码
$ popdf pdf2docx --input_file report.pdf --output_file report.docx

# 所有功能都可通过 CLI 调用
$ popdf --help

🏗️ 项目架构

分层清晰,易扩展、易维护

📡 API 层
pdf.py — 对外接口 & CLI
⚙️ Core 层
PDFType / Batch_PDFType
🛠 Lib 层
pdf2docx / PyMuPDF / pypdf …

🎯 三种使用形态

无论你是开发者还是普通用户,总有一种适合你

🐍

Python 库

pip install popdf,import 即用,3 行代码搞定 PDF 操作

pip install popdf
🖥️

桌面 GUI

基于 PySide6 的桌面应用,可视化操作,支持打包为 .exe

python gui/run.py
🌐

Web 应用

基于 React + TypeScript 的前端工具,浏览器本地处理

cd web && npm run dev

🤝 加入社区

开源项目欢迎你的参与