Skip to content

elecmonkey/pdf-watermark-remover

Repository files navigation

PDF水印删除工具

这是一个用于删除PDF文件中文字水印的Python工具,使用PyMuPDF库实现精确查找并删除水印文本。

功能特点

  • 支持精确查找并删除指定文本水印
  • 图片形式水印此工具无法删除
  • 保持原PDF文件的其他内容不变

环境设置

  1. 创建并激活虚拟环境:
# 创建虚拟环境
python3 -m venv venv

# 如果使用 bash/zsh
source venv/bin/activate

# 如果使用 fish shell
source venv/bin/activate.fish

# 如果使用 Windows
.\venv\Scripts\activate
  1. 安装依赖:
pip install -r requirements.txt

使用方法

图形界面方式

  1. 确保虚拟环境已激活(命令行前面会显示 (venv)
  2. 运行以下命令启动图形界面:
# 直接运行Python脚本
python gui.py
  1. 在图形界面中:
    • 拖放或选择PDF文件
    • 输入要删除的水印文本
    • 点击"开始处理"按钮

命令行方式

  1. 确保虚拟环境已激活(命令行前面会显示 (venv)
  2. 运行以下命令:
python main.py input.pdf output.pdf "水印文本"
  1. 完成后可以退出虚拟环境:
deactivate

构建说明

  1. 确保已安装所有依赖:
pip install -r requirements.txt
  1. 使用PyInstaller构建应用程序:

macOS构建

# 清理之前的构建文件
rm -rf build dist

# 使用spec文件构建
pyinstaller "PDF水印删除工具.spec"

Windows构建

# 清理之前的构建文件
rmdir /s /q build dist

# 使用spec文件构建
pyinstaller "PDF水印删除工具.spec"

Linux构建

# 清理之前的构建文件
rm -rf build dist

# 使用spec文件构建
pyinstaller "PDF水印删除工具.spec"
  1. 构建完成后,应用程序将位于 dist 目录下:
    • macOS: dist/PDF水印删除工具.app
    • Windows: dist/PDF水印删除工具.exe
    • Linux: dist/PDF水印删除工具

spec文件是PyInstaller的配置文件,它定义了:

  • 应用程序的基本信息(名称、版本等)
  • 需要打包的Python脚本和依赖项
  • 资源文件(如图标、数据文件等)
  • 构建选项(如是否显示控制台窗口)
  1. 测试构建的应用程序:
    • 在macOS上:双击 dist/PDF水印删除工具.app 运行
    • 在Windows上:双击 dist/PDF水印删除工具.exe 运行
    • 在Linux上:在终端中运行 ./dist/PDF水印删除工具

许可证

本项目采用GNU Affero General Public License v3.0 (AGPL-3.0)许可证,并使用了以下开源库:

  • PyMuPDF (AGPL-3.0): 用于PDF处理
  • PySide6 (LGPL-3.0): 用于图形界面
  • PyInstaller (GPL-2.0): 用于应用程序打包

根据这些库的许可证要求,如果您分发包含这些库的二进制文件,需要遵守相应的许可证条款。特别是,由于使用了AGPL-3.0许可证的PyMuPDF,整个项目必须遵循AGPL-3.0的要求,包括在提供网络服务时必须提供源代码。

About

A GUI & CLI application designed to remove text watermarks from PDF files based on PyMuPDF library.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages