PDFRedactor

PDFRedactor is a Python tool for redacting sensitive information from PDF files. The script can detect and redact phone numbers, email addresses, links, IBANs, BICs, timestamps, dates, QR Codes, Barcodes and custom text patterns from PDF documents.

Features

• Phone Numbers: Redacts phone numbers.
• Email Addresses: Redacts email addresses.
• Links: Redacts links/urls/hyperlinks.
• IBANs: Redacts detected International Bank Account Numbers.
• BICs: Redacts detected Bank Identifier Codes.
• Timestamps: Redacts detected timestamps.
• Dates: Redacts detected dates in various formats.
• Custom Text Patterns: Redact any custom text pattern specified by the user.
• QRCodes and Barcodes

Installation

To install PDFRedactor, follow these steps:

1. Clone the repository:

   git clone https://github.com/ltillmann/pdf-redactor.git

2. cd into the cloned directory

3. Install the required dependencies using pip:

   pip3 install -r requirements.txt

   requirements.txt is the single authoritative dependency file for this project. This project currently targets PyMuPDF 1.27.2.

   QR code and barcode support also require the zbar shared library at runtime. On macOS, install it with:

   brew install zbar

4. Make the script executable or pass the script directly to python:

   chmod +x pdf_redactor.py

Quick start

You can run the executable script from the command line:

./pdf_redactor.py [-h] -i INPUT [-o OUTPUT] [-e] [-l] [-p] [-v] [-m MASK]
                  [-t TEXT] [-c {white,black,red,green,blue}]
                  [-C {white,black,red,green,blue}] [-d] [-f] [-s] [-b]
                  [-r] [-q] [-x COLOR_HEX] [-X TEXT_COLOR_HEX]

Below are the available options:

Options

• -h, --help: Show help message and exit.
• -i INPUT, --input INPUT: Filename or directory path to be processed.
• -o OUTPUT, --output OUTPUT: Filename or directory path to save redacted files to. For a single input file, this may be either a .pdf file path or a directory.
• -e, --email: Redact all email addresses.
• -l, --link: Redact all links.
• -p, --phonenumber: Redact all phone numbers.
• -v, --preview: Preview redacted areas before continuing.
• -g GEOGRAPHIC_CODE, --geographic-code GEOGRAPHIC_CODE: Geographic code for phone number detection (e.g. US, GB, FR) for better accuracy.
• -m MASK, --mask MASK: Custom word mask to redact, e.g. "John Doe" (case insensitive). Multiple masks can be specified by using this flag multiple times, e.g. -m "text1" -m "text2".
• -t TEXT, --text TEXT: Text to show in redacted areas. Default: None.
• -c {white,black,red,green,blue}, --color {white,black,red,green,blue}: Fill Color of redacted areas. Default: "black".
• -C {white,black,red,green,blue}, --text_color {white,black,red,green,blue}: Fill Color of text over redacted areas. Default: "white".
• -d, --date: Redact all dates (dd./-mm./-yyyy).
• -f, --timestamp: Redact all timestamps.
• -s, --iban: Redact all IBANs (International Bank Account Numbers).
• -b, --bic: Redact all BICs (Bank Identifier Codes).
• -r, --barcode: Redact all barcodes.
• -q, --qrcode: Redact all QR Codes.
• -x COLOR_HEX, --color-hex COLOR_HEX: Fill color of redacted areas in HEX ("#000000").
• -X, TEXT_COLOR_HEX, --text-color-hex TEXT_COLOR_HEX: Text color of redacted areas in HEX ("#FFFFFF").

Examples

1. Redact phone numbers from a single PDF file:

   ./pdf_redactor.py -i input_file.pdf -p

2. Redact phone numbers with geographic code for better accuracy:

   ./pdf_redactor.py -i input_file.pdf -p -g US

3. To redact email addresses and preview redacted areas:

   ./pdf_redactor.py -i input_file.pdf -e -v

4. Redact a custom text pattern and specify redaction text for a directory of PDF files:

   ./pdf_redactor.py -i directory_path -m "CONFIDENTIAL" -t "[REDACTED]"

5. Redact multiple custom text patterns:

   ./pdf_redactor.py -i input_file.pdf -m "texte1" -m "texte2" -m "texte3"

6. Save a redacted single PDF into an output directory:

   ./pdf_redactor.py -i input_file.pdf -o redacted/ -m "CONFIDENTIAL"

Preview Redactions

When using the -v or --preview option, the script will display a preview of the pending redaction batch for a page and prompt you to continue with the redaction or abort.

Limitations

• Most detection features rely on regular expressions, which may not cover all possible formats or variations.
• QR code and barcode detection depend on pyzbar plus the system zbar shared library. If zbar is unavailable, the script will continue to work but disable QR/barcode detection.
• PDFRedactor still does not cover metadata, names, addresses, SSNs, tables, labels and other document structures outside the supported detectors above.

License

This project is licensed under the MIT License.

Acknowledgments

• This tool utilizes the PyMuPDF library for OCR and PDF processing PyMuPDF.
• To detect phone numbers, I used David Drysdales Python port of Google's libphonenumber python-phonenumbers.
• To detect QR/Barcodes, I utilized pyzbar library for the most consistent results pyzbar.

Contributing

Contributions are welcome! Please feel free to open a pull request or report an issue.