Blackout Proof
Add value-free HTML page geometry previews, opt-in local OCR counts and redaction edge-case fixtures.
The problem it solves
Blackout Proof Blackout Proof checks a PDF locally for structural evidence that sensitive material may still be recoverable after redaction.
Who Blackout Proof is for
- People handling browser, web, or document data who want a local and inspectable workflow.
- Users working with PDF, privacy, redaction who want the documented v1.1.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Add value-free HTML page geometry previews, opt-in local OCR counts and redaction edge-case fixtures.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.1.0
Capabilities below come from the current project README and release documentation.
Blackout Proof checks a PDF locally for structural evidence that sensitive material may still be recoverable after redaction.
It reports extractable text intersecting dark opaque covers, populated metadata, embedded files, JavaScript, optional-content layers, interactive forms, and remaining annotations. Reports use counts and locations without repeating document text, metadata values, filenames of attachments, or comments.
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Verified release evidence
This project does not currently publish a screenshot or dedicated example folder. The current README, tests, changelog, tagged release, and source repository remain the verified examples of its behavior.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Windows
- macOS
- Linux
Built with
- Python
- PyMuPDF
What changed in v1.1.0
Add value-free HTML page geometry previews, opt-in local OCR counts and redaction edge-case fixtures.
blackout-proof sample.pdf --format html --output review.htmlHTML links page findings to geometry-only previews of dark cover rectangles. To preserve value-free reports, previews omit all source text and imagery rather than embedding source PDF/raster content. --ocr optionally invokes local PyMuPDF/Tesseract OCR and reports only word counts or engine-unavailable status; it is a review aid and never proof of sanitization. Tests generate rotated text/pages, transparent covers, optional layers, applied redactions, encrypted and damaged PDFs and assert source hashes are unchanged. The OCR adapter is tested with controlled success/failure substitutes; native Tesseract acceptance is not claimed. Existing outputs are protected and encrypted PDFs require prior authorized local decryption.
Quick start
The shortest documented path into the current release.
python -m pip install .
blackout-proof document.pdf --output redaction-check.md
blackout-proof document.pdf --format json --fail-on-findingsCurrent limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
- This is a verification aid, not a redaction editor, legal certification, malware scanner, or guarantee that a document is safe.
- Image-only secrets require human visual review; the tool does not perform OCR.
- Opaque-cover detection is conservative and may flag intentional design elements that overlap text.
- Encrypted or damaged PDFs may be unreadable and should fail closed.
- Files never leave the computer; there is no telemetry, network request, or source modification.
Supported on Python 3.10+ for Windows, macOS, and Linux. Current release: v1.1.0. Contributions are reviewed through pull requests. MIT licensed.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
No privacy behavior beyond the current repository documentation is claimed. Review the source, security policy, and input/output behavior before using sensitive material.
License and release
Blackout Proof is published under MIT. The current cataloged release is v1.1.0, published 2026-09-07.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Blackout Proof v1.1.0
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical local repository. Fingerprint: 08f071ae74f55d0d.