geimist/synOCR v1.5.0 on GitHub

1.5.0 [2025-03-28]

⚠️ bekannte Probleme / Einschränkungen / known issues / limitations:

Geräte mit einer ARM64 / aarch64 CPU werden mit dieser Version aufgrund von Python-Inkompatibilität nicht unterstützt❗️
Devices with an ARM64 / aarch64 CPU are not supported with this release due to Python incompatibility❗️

📦 SPK DOWNLOAD: DSM6 | DSM7

Folgende Funktionen erwarten dich mit dem Update auf synOCR Version 1.5.0:
The complete changelog in english language can be found here.

🔥 neue Funktionen

entfernen von Leerseiten

synOCR kann nun auf Wunsch Leerseiten erkennen und entfernen. Für eine granulare Steuerung gibt es einen neuen Bereich in der GUI:

In der Regel sollte der Hauptregler für die Empfindlichkeit ausreichen.

Dieser Wert bestimmt, wie stark der durchschnittliche Helligkeitswert des Bildes reduziert wird, um Leerseiten zu erkennen. Erhöhe den Wert (z. B. -40), um empfindlicher auf Inhalte zu reagieren (mehr Seiten als nicht leer erkennen). Verringere den Wert (z. B. -60), um strenger zu sein (mehr Seiten als leer erkennen).

In den Experteneinstellungen gibt es noch folgende Detaileinstellungen:

Funktion	Beschreibung
`Text ignorieren`	In den Standardeinstellungen wird jede Seite übersprungen, sobald mindestens ein Zeichen gefunden wird. Auf manchen Scans scheint aber Text auf einer leeren Seite von der Rückseite durch, was zu sinnlosem Text führen kann. Mit dieser Einstellung wird ausschließlich eine optische Prüfung durchgeführt.
`Beschneiden (Breite)` / `Beschneiden (Höhe)`	Beschneidet den Erkennungsbereich um angegebene Prozent in der Breite, um störende Elemente wie Heftklammern oder Lochränder zu ignorieren. Passe die Werte an, wenn deine Dokumente ungewöhnliche Randbereiche haben (0.1 entsprechen 10%). Der Standardwert für die Breite ist `0.1` und für die Höhe `0.05`.
`max. Filtergröße (Rauschreduzierung)`	Entfernt kleine Störungen (wie Staub oder leichte Markierungen) durch Filteroperationen. Ein höherer Wert vergrößert den Radius des Filters (weiße Bereiche), um kleine schwarze Störpixel zu entfernen.
`min. Filtergröße (Textverstärkung)`	Ein höherer Wert vergrößert den Radius des Filters (schwarze Bereiche), um Text klarer hervorzuheben. Höhere Werte wirken stärker.
`Schwellwert schwarze Pixel`	Legt den Grenzwert für den Anteil an nicht weißen Pixeln fest, um eine Seite als leer zu klassifizieren. Verringere den Wert, um strengere Kriterien für Leerseiten anzuwenden und erhöhe den Wert, um toleranter gegenüber leeren Seiten zu sein. Standardwert: `0.005`

anpassen der Bildqualität

Funktion	Beschreibung
`Schwellwert für schwarzweiß`	Der Schwarzweiß-Modus erzeugt sehr kleine Dateien bei sehr gutem Kontrast und Schärfe. Für Textdokumente ohne wichtige Grafiken ist das ideal. Der Schwellenwert bestimmt, ab welcher Helligkeit (0-255) ein Pixel als weiß interpretiert wird. Du kannst diesen Wert anpassen: – Niedrigerer Wert (z. B. `20`): Mehr Pixel werden schwarz – Höherer Wert (z. B. `160`): Mehr Pixel werden weiß Empfohlener Wert: `40` `deaktiviert` ➜ Die Schwarzweiß-Konvertierung ist ausgeschaltet.
`DPI Anpassung`	Die DPI Zahl muss bei Farbanpassungen definiert werden. Wird kein Wert definiert, wird bei Farbanpassungen 300 DPI verwendet. Ist die DPI Anpassung definiert, werden alle Dokumente entsprechend angepasst. `deaktiviert` ➜ Die manuelle DPI Anpassung ist ausgeschaltet.
`Kontrast Anpassung`	Durch die Anpassung des Kontrasts können undeutliche Scans verbessert werden. `deaktiviert` ➜ Die Kontrast Anpassung ist ausgeschaltet.
`Schärfe Anpassung`	Durch die Anpassung der Schärfe können undeutliche Scans verbessert werden. `deaktiviert` ➜ Die Schärfe Anpassung ist ausgeschaltet.

Wartezeit für inotify-inkompatible Scanner

Besonders bei CANON und ScanSnap Scannern ist das Verhalten zu beobachten, dass jede Seite einzeln auf die Netzwerkfreigabe des NAS gespeichert wird und für jede weitere Seite die bestehende PDF-Datei erneut geöffnet und geschlossen wird. Das triggert die Ordnerüberwachung Inotify (event: close_write ) oder kann mit einem automatischen Zeitplan kollidieren.

Für diesen Zweck bietet synOCR nun ein Offset, d.h. ein Zeitversatz in Sekunden, bis eine Datei verarbeitet wurde.
Einstellbar ist ein Bereich von 0-120 Sekunden

Datei Log

Wenn die Protokollierung aktiviert ist, wird nun die Datei file_processing.log im Log-Ordner abgelegt, um einen schnellen Überblick über die Zieldateien zu erhalten.
Jede Quelldatei erhält einen Eintrag mit Zeitstempel und dem Vermerk unsuccessful. Wurde die Datei erfolgreich verarbeitet, wird unsuccessful durch den Pfad zur Zieldatei ersetzt. Damit lässt sich schnell nachvollziehen, ob alle Dateien wie gewünscht verarbeitet wurden und in welches Zielverzeichnis sie einsortiert wurden.

Originaldateien beibehalten

Mit dem neuen OCR-Parameter --keep_hash können nun die Quelldateien beibehalten werden.
Hierbei wird die Quelldatei für die Klassifizierung nur temporär verarbeitet und durchsucht, die Zieldatei ist aber letztendlich identisch mit der Quelldatei.

jede Seite trennen

Es gibt Szenarien, wo ein Quelldokument bei jeder Seite aufgetrennt werden soll, ohne das jedes Mal ein Trennblatt verwendet werden soll. Dafür gibt es jetzt eine eigene Option in der GUI:

dynamische Pfade per RegEx

Der YAML-Key dirname_RegEx dient als Äquivalent zu tagname_RegEx aber für den Pfad. Wie in diesem Beispiel gezeigt, kann der User damit dynamische Zielordner aufgrund eines RegEx definieren:

rule_subdir:
    tagname: 
    targetfolder: /myPath/§dirname_RegEx
    dirname_RegEx: W2[56]-[0-9]{4}
    subrules:
    - searchstring: W2[56]-[0-9]{4}
      isRegEx: true

💎 Verbesserungen

Details

[GUI] deutlich verbesserte GUI-Geschwindigkeit
[GUI] duplizierte oder neu erstellte Profile werden sofort geladen / ausgewählt
[shell] alle nicht alphanumerischen Zeichen im Zieldateinamen werden auf eins reduziert (issue #58)
[GUI] wo möglich, wurden Textfelder und Optionsfelder durch Schieberegler und Schalter ersetzt
[GUI] es gibt nun einen optischen Indikator, der einen Profilwechsel anzeigt (der redundante Button wurde entfernt)
[shell] die RegEx D-M-Y, D.M.Y und D/M/Y in search_all_numeric_dates wurden geändert, um die Suche nach 2- und 4-stelligen Jahreszahlen zu ermöglichen. (#56 thx @dklinger)
[shell] Bump apprise library to 1.9.2
[GUI] Bump Bootstrap framework to 5.3.2 (thx @toafez)
[GUI] Bump jQuery to 3.7.1 (thx @toafez)
[GUI] ungültige Quellverzeichnisse wurden in der GUI angezeigt
[shell] update find_dates.py von Version v0.4 ➜ v0.6 (thx @Gthorsten)
search_alpha_numeric_dates()
-change regex after user hint
search_alpha_numeric_dates()
- Optimierung der Suche nach kurzen Daten (jun., Apr. …)
- Bugfix Regex mit Leerzeichen nach Monat
- Protokollierung verbessert
[shell] die Erkennung / Zählung von Duplikaten in der Zieldatei ist jetzt zuverlässiger
[shell] Verwendung der nativen DSM-Berechtigungsanpassung
[shell] Verbesserter Schutz der Quelldatei im Falle eines Fehlers

🛠️ Bugfixe