paperless-blacklist

Ein Post-Processor für Paperless-ngx, der falsch erkannte Datumswerte korrigiert.

Problem

Wenn OCR/Parsing zufällig deinen Geburtstag als Dokumentdatum (created) erkennt, wird ein falsches Metadatum gesetzt.

Verhalten

Das Skript prüft bei einem verarbeiteten Dokument den created-Wert. Wenn dieser auf MY_BIRTH_DATE fällt, wird das Datum per API auf null gesetzt.

Wichtig für Docker / Paperless

Wenn du in Paperless gesetzt hast:

• PAPERLESS_POST_CONSUMPTION_SCRIPT: "/config/scripts/post_consumption.py"

muss genau diese Datei im Container vorhanden sein. In diesem Repo gibt es deshalb zusätzlich post_consumption.py als Entry-Point.

Außerdem nutzt das Script keine externen Python-Pakete (kein requests) und läuft dadurch auch in minimalen Container-Images.

Umgebungsvariablen

• DOCUMENT_ID (von Paperless gesetzt)
• PAPERLESS_API_TOKEN (erforderlich)
• MY_BIRTH_DATE (erforderlich, Format YYYY-MM-DD)
• PAPERLESS_API_URL (optional, Standard: http://localhost:8000/api/documents/)
• REQUEST_TIMEOUT_SECONDS (optional, Standard: 10)

Beispiel (docker-compose)

environment:
  PAPERLESS_POST_CONSUMPTION_SCRIPT: /config/scripts/post_consumption.py
  PAPERLESS_API_TOKEN: <token>
  MY_BIRTH_DATE: "1990-01-31"
volumes:
  - ./post_consumption.py:/config/scripts/post_consumption.py:ro
  - ./paperless_blacklist.py:/config/scripts/paperless_blacklist.py:ro

Lokal testen

python3 paperless_blacklist.py