Installation

Repository und Paket

curl -fsSL https://deb.ralfhartmann.dev/repo.gpg.key \
  | sudo gpg --dearmor \
  -o /usr/share/keyrings/rhpost-archive-keyring.gpg

. /etc/os-release
case "$VERSION_CODENAME" in
  bookworm|trixie) ;;
  *) echo "Debian 12 oder 13 erforderlich"; exit 1 ;;
esac
printf "deb [signed-by=/usr/share/keyrings/rhpost-archive-keyring.gpg] https://deb.ralfhartmann.dev %s main\ndeb-src [signed-by=/usr/share/keyrings/rhpost-archive-keyring.gpg] https://deb.ralfhartmann.dev %s main\n" \
  "$VERSION_CODENAME" "$VERSION_CODENAME" \
  | sudo tee /etc/apt/sources.list.d/scanworker.list

sudo apt-get update
sudo apt-get install scanworker

Bookworm und Trixie

Debian 12 Bookworm und Debian 13 Trixie besitzen getrennte signierte Paketindizes. Das architekturunabhängige Binärpaket und sein GPL-Quellpaket werden in beiden Auslieferungen geprüft.

Direktdownload

Das aktuelle stabile Debian-Paket kann auch direkt geladen werden. Für automatische Aktualisierungen ist die APT-Einrichtung vorzuziehen.

Nach Aktivierung von deb-src steht derselbe Quellcode mit apt source scanworker bereit. Ein zusätzliches ZIP ist nicht nötig: .dsc und .tar.xz sind die standardisierten Debian-Quellpakete.

SHA-256-, Binär- und Quellpaketmetadaten stehen in den signierten APT-Indizes. Entwicklungspakete aus trixie-dev werden hier bewusst nicht angeboten.

Optionale VLM-Analyse

Der Basisablauf funktioniert vollständig mit Tesseract. PaddleOCR-VL ist ein separater lokaler Dienst und kann auf einer CPU-Maschine ohne Cloud-API betrieben werden.

Scanner-Eingänge konfigurieren

In /etc/scanworker/scanworker.conf nimmt der Duplex-Eingang zwei Simplex-Läufe zum Paaren auf; der Single-Eingang verarbeitet eine bereits vollständige PDF direkt mit OCR:

DUPLEX_INPUT_DIR=/srv/scan/duplex
SINGLE_INPUT_DIR=/srv/scan/single

Ohne DUPLEX_INPUT_DIR bleibt ein vorhandenes INPUT_DIR als Duplex-Eingang wirksam. Nach der Änderung werden die Scanworker-Dienste neu gestartet.