Feature: attempt to clean some PDFs with qpdf

2024-09-05 21:53:45 -07:00
parent c92c3e224a
commit 9e59e02ffa
7 changed files with 90 additions and 3 deletions
--- a/docs/advanced_usage.md
+++ b/docs/advanced_usage.md
@@ -418,6 +418,15 @@ Insurances/                             # Insurances
    Defining a storage path is optional. If no storage path is defined for a
    document, the global [`PAPERLESS_FILENAME_FORMAT`](configuration.md#PAPERLESS_FILENAME_FORMAT) is applied.

+## Automatic recovery of invalid PDFs {#pdf-recovery}
+
+Paperless will attempt to "clean" certain invalid PDFs with `qpdf` before processing if, for example, the mime_type
+detection is incorrect. This can happen if the PDF is not properly formatted or contains errors.
+
+!!! warning
+
+    This process will technically modify the document before processing.
+
 ## Celery Monitoring {#celery-monitoring}

 The monitoring tool