Ich wollte gern eine Scan-Station f\u00fcr Dokumente realisieren, an der ich eingehende Papierdokumente (vorwiegend im Format A4) in einen Dokumentenscanner lege, der diese dann wiederum auf Knopfdruck in einer Netzwerkfreigabe auf meinem NAS ablegt. Idealerweise – diesen Job h\u00e4tte allerdings auch das NAS ausf\u00fchren k\u00f6nnen – sollte dabei gleich die Texterkennung durchgef\u00fchrt werden, damit die Dokumente im Anschluss durchsuchbar sind.<\/p>\n\n\n\n
Raspberry Pi Zero W<\/h2>\n\n\n\n![\"\"](\"https:\/\/www.richard-becker.net\/blog\/wp-content\/uploads\/2023\/07\/raspberry-pi-1904918_1920-e1690102478179-1024x445.jpg\")
<\/figure>\n\n\n\nDa ich noch einen Raspberry Pi Zero W herumliegen hatte, dachte ich mir, dass es naheliegend sei, das Ganze mit diesem umzusetzen. Schnell wurde mir jedoch klar, dass die meisten ben\u00f6tigten Bibliotheken f\u00fcr Rapsbian OS zu alt waren, als dass sie f\u00fcr mich n\u00fctzlich gewesen w\u00e4ren: So war „SANE<\/a>“ beispielsweise nur in der (Backend-)Version 1.0.27 verf\u00fcgbar, der von mir eingesetzte Dokumentenscanner Epson Workforce DS-310 funktioniert allerdings erst mit neueren Versionen. (Hinweis: Mit \u00e4lteren Versionen hat er nicht „gar nicht“ funktioniert, allerdings kam es zu h\u00e4ufigen Verbindungsabbr\u00fcchen und fehlerhaften Scans.)
Zudem schien mir die Adapter-Verbindung zwischen USB-A und Micro-USB (der kleine Raspberry Zero hat keinen gro\u00dfen USB-Port) nicht besonders zuverl\u00e4ssig zu funktionieren!<\/p>\n\n\n\nRaspberry Pi 3+<\/h2>\n\n\n\n![\"\"](\"https:\/\/www.richard-becker.net\/blog\/wp-content\/uploads\/2023\/07\/device-3438525_1920-e1690102504298-1024x453.jpg\")
<\/figure>\n\n\n\nKurzerhand habe ich dann einen Raspberry Pi 3+ eingesetzt, der bislang eine andere (wenig ben\u00f6tigte) Funktion in meinem Netzwerk \u00fcbernahm. Auf ihm habe ich ein Ubuntu mit Hilfe des Raspberry Pi Imagers<\/a> aufgesetzt und anschlie\u00dfend SANE installiert.<\/p>\n\n\n\nInstallation von SANE<\/h3>\n\n\n\nsudo apt-get update\r\nsudo apt-get upgrade\r\nsudo apt install sane sane-utils scanbd git imagemagick -y<\/code><\/pre>\n\n\n\n(Angelehnt habe ich diesen Prozess an das Vorgehen von Chris Schuld hier: https:\/\/chrisschuld.com\/2020\/01\/network-scanner-with-scansnap-and-raspberry-pi\/<\/a>)<\/p>\n\n\n\nUnter Ubuntu f\u00fcr den Raspberry Pi 3+ konnte ich zwar immer noch nicht die neuste Version von SANE installieren, immerhin aber die (Backend-)Version 1.1.1, die den Drucker korrekt unterst\u00fctzt. (Pr\u00fcfen kann man das in der Liste der unterst\u00fctzten Ger\u00e4te<\/a>.) Im Anschluss habe ich meinen Benutzer der Gruppe „scanner“ hinzugef\u00fcgt, unter der SANE arbeitet.<\/p>\n\n\n\nsudo usermod -a -G scanner <BENUTZER><\/code><\/pre>\n\n\n\nMit folgenden Befehlen konnte ich dann schauen, ob sich der Scanner zu erkennen gibt und sogar etwas scannt:<\/p>\n\n\n\n
# Listet alle USB-Ger\u00e4te\r\nlsusb\r\n\r\n# Sucht nach Scannern am USB-Bus\r\nsudo sane-find-scanner\r\n\r\n# Pr\u00fcft, ob der Scanner korrekt von SANE erkannt wurde\r\nsudo scanimage -L\r\n\r\n# Scannt ein Bild und leitet es in ein tempor\u00e4res Verzeichnis um. Wer hineinsehen will, kann dies an einem Rechner mit GUI unter GIMP tun.\r\nsudo scanimage >\/tmp\/out.pnm<\/code><\/pre>\n\n\n\nInstallation von sane-scan-pdf<\/h3>\n\n\n\n
Raman Gupta hat mit „sane-scan-pdf<\/a>“ ein Script bereitgestellt, dass die ganze „harte Arbeit“ \u00fcbernimmt, die passenden Befehle zu verketten, um tats\u00e4chlich mehrere Seiten per automatischem Papiereinzug zu einer PDF zu verketten und eine OCR laufen zu lassen. Installieren l\u00e4sst es sich mit:<\/p>\n\n\n\ncd $HOME\r\ngit clone https:\/\/github.com\/rocketraman\/sane-scan-pdf.git<\/code><\/pre>\n\n\n\nNach kurzem Ausprobieren musste ich feststellen, dass das Script meine Scans ohne OCR mit „pnmtops“, einem Tool, dass aus dem PNM-Format PostScript Dateien erstellt, konvertiert wurde und dabei irgendwie auf der resultierenden Seite nicht korrekt positioniert wurde. Auch die Option „-nocenter“ brachte keine Abhilfe\u2026 ein Teil auf der Seite oben blieb abgeschnitten.
Ein Workaround, der f\u00fcr mich (gut!) funktioniert, ist der Einsatz von „tesseract“ zur Texterkennung. Damit wird mein Scan korrekt dargestellt und durchsuchbar – exakt das, was ich wollte.<\/p>\n\n\n\n
Mit folgendem Script lief dann der ganze Scanvorgang wie am Schn\u00fcrchen:<\/p>\n\n\n\n
#!\/bin\/sh\n\nnow=date +\"%Y-%m-%d-%H%M\"\n\/home\/<BENUTZER>\/sane-scan-pdf\/scan -d -r 200 -v -m Color --device \"\" -xo \"-y 297.0\" --no-default-size --ocr --language deu -o \/home\/<BENUTZER>\/scans\/scan-$now.pdf<\/code><\/pre>\n\n\n\nScannen in einen Netzwerkordner<\/h3>\n\n\n\n![\"\"](\"https:\/\/www.richard-becker.net\/blog\/wp-content\/uploads\/2023\/07\/server-g2a28b7049_1280-e1688994604279-1024x412.jpg\")
<\/figure>\n\n\n\nNat\u00fcrlich wollte ich die gescannten Dateien nicht lokal sondern auf einer SAMBA-Netzwerkfreigabe meines NAS ablegen. Dazu habe ich den Ordner „\/mnt\/scans“ erstellt:<\/p>\n\n\n\n
sudo mkdir \/mnt\/scans<\/code><\/pre>\n\n\n\nDanach musste ich die Datei „\/home\/\/.credentials\/scanserver“ mit folgendem Inhalt erstellen:<\/p>\n\n\n\n
username=<NAS-BENUTZER>\r\npassword=<FREIGABE-PASSWORT><\/code><\/pre>\n\n\n\nIm Anschluss habe ich noch die Datei „\/etc\/fstab“ bearbeitet und folgende Zeile erg\u00e4nzt:<\/p>\n\n\n\n
\/\/<IP-Adresse>\/scans \/mnt\/scans cifs user,credentials=\/home\/<BENUTZER>\/.credentials\/scanserver,iocharset=utf8,vers=2.0,_netdev,x-systemd.automount,x-systemd.after=network-online.target,noperm 0 0<\/code><\/pre>\n\n\n\nDanach mussten nur noch alle Laufwerke neu gemountet werden:<\/p>\n\n\n\n
sudo mount -a<\/code><\/pre>\n\n\n\nAuch im obenstehenden Script, das den Scanvorgang \u00fcbernimmt, habe ich dann als Zielverzeichnis die Netzwerkfreigabe und nicht l\u00e4nger das lokale Verzeichnis \u00fcbernommen.<\/p>\n\n\n\n
scanbd Alternative – mein Scanner macht seine Buttons nicht \u00f6ffentlich zug\u00e4nglich<\/h3>\n\n\n\n![\"\"](\"https:\/\/www.richard-becker.net\/blog\/wp-content\/uploads\/2023\/07\/printing-2790795_1920-e1690104222860-1024x199.jpg\")
<\/figure>\n\n\n\nDen Knopfdruck des Scanners abzufragen stellte sich dann als n\u00e4chste H\u00fcrde heraus. Auf dem herk\u00f6mmlichen Weg, n\u00e4mlich mit scanbd, lie\u00dfen sich die Buttons nicht abfragen, da der Scanner ihren Status nicht \u00f6ffentlich preisgibt.<\/p>\n\n\n\n
Entsprechend habe ich folgende Anleitung<\/a> befolgt und versucht, es2button von Jan Ruethzu kompilieren und zu installieren. <\/p>\n\n\n\nDownload von Github ins Home-Verzeichnis:<\/p>\n\n\n\n
cd $HOME\ngit clone https:\/\/github.com\/janrueth\/es2button.git<\/code><\/pre>\n\n\n\nKompilieren vorbereiten (hierbei wird auch die Source vom Treiber „epsonscan2“ heruntergeladen):<\/p>\n\n\n\n
cd es2button\ncmake . -B build<\/code><\/pre>\n\n\n\nKompilieren:<\/p>\n\n\n\n
make -C build<\/code><\/pre>\n\n\n\nDebian-Package erstellen:<\/p>\n\n\n\n
make -C build package<\/code><\/pre>\n\n\n\nDie .deb-Datei findet sich dann in build\/artifacts\/<\/code>. Sie konnte dann aber noch nicht installiert werden, denn hier sollte mir die Architektur des Rapsberry Pi mit Ubuntu (ARM64) einen Strich durch die Rechnung machen. Zwar lassen sich alle Abh\u00e4ngigkeiten in Form von Softwarepaketen installieren, gerade der ben\u00f6tigte Scanner-Treiber von Epson („epsonscan2“) ist aber nicht f\u00fcr diese Prozessorarchitektur kompiliert, was ich dann noch selbst \u00fcbernehmen musste. Zwei Stunden (ja, leider!) sollten f\u00fcr diesen Prozess einkalkuliert werden. Hier bin ich dieser Anleitung<\/a> von Epson selbst gefolgt. <\/p>\n\n\n\nDie Quelle des Treibers hatte ich ja schon herunterladen lassen, diese musste ich mir nur noch an einen vern\u00fcnftigen Ort kopieren:<\/p>\n\n\n\n
cd $HOME\ncd es2button\/build\ncp epsonscan2-<VERSIONSNUMMER>.src.tar.gz ~\ntar -xvzf epsonscan2-<VERSIONSNUMMER>.src.tar.gz\nmv epsonscan2-<VERSIONSNUMMER>.src.tar.gz epsonscan2<\/code><\/pre>\n\n\n\nIm Anschluss konnte ich das Kompilieren\/Installieren vorbereiten, indem ich die ben\u00f6tigten Abh\u00e4ngigkeiten installiert habe:<\/p>\n\n\n\n
cd $HOME\ncd epsonscan2\n.\/install-deps<\/code><\/pre>\n\n\n\nWeiter ging es mit:<\/p>\n\n\n\n
cmake .<\/code><\/pre>\n\n\n\nDas ging noch verh\u00e4ltnism\u00e4\u00dfig schnell (wenige Minuten), der folgende Prozess dauert dann allerdings in etwa eineinhalb bis zwei Stunden:<\/p>\n\n\n\n
make<\/code><\/pre>\n\n\n\nDanach konnte epsonscan2 installiert werden, das ging wieder recht schnell (wenige Minuten):<\/p>\n\n\n\n
sudo make install<\/code><\/pre>\n\n\n\n
<\/figure>\n\n\n\nDa ich noch einen Raspberry Pi Zero W herumliegen hatte, dachte ich mir, dass es naheliegend sei, das Ganze mit diesem umzusetzen. Schnell wurde mir jedoch klar, dass die meisten ben\u00f6tigten Bibliotheken f\u00fcr Rapsbian OS zu alt waren, als dass sie f\u00fcr mich n\u00fctzlich gewesen w\u00e4ren: So war „SANE<\/a>“ beispielsweise nur in der (Backend-)Version 1.0.27 verf\u00fcgbar, der von mir eingesetzte Dokumentenscanner Epson Workforce DS-310 funktioniert allerdings erst mit neueren Versionen. (Hinweis: Mit \u00e4lteren Versionen hat er nicht „gar nicht“ funktioniert, allerdings kam es zu h\u00e4ufigen Verbindungsabbr\u00fcchen und fehlerhaften Scans.) Kurzerhand habe ich dann einen Raspberry Pi 3+ eingesetzt, der bislang eine andere (wenig ben\u00f6tigte) Funktion in meinem Netzwerk \u00fcbernahm. Auf ihm habe ich ein Ubuntu mit Hilfe des Raspberry Pi Imagers<\/a> aufgesetzt und anschlie\u00dfend SANE installiert.<\/p>\n\n\n\n (Angelehnt habe ich diesen Prozess an das Vorgehen von Chris Schuld hier: https:\/\/chrisschuld.com\/2020\/01\/network-scanner-with-scansnap-and-raspberry-pi\/<\/a>)<\/p>\n\n\n\n Unter Ubuntu f\u00fcr den Raspberry Pi 3+ konnte ich zwar immer noch nicht die neuste Version von SANE installieren, immerhin aber die (Backend-)Version 1.1.1, die den Drucker korrekt unterst\u00fctzt. (Pr\u00fcfen kann man das in der Liste der unterst\u00fctzten Ger\u00e4te<\/a>.) Im Anschluss habe ich meinen Benutzer der Gruppe „scanner“ hinzugef\u00fcgt, unter der SANE arbeitet.<\/p>\n\n\n\n Mit folgenden Befehlen konnte ich dann schauen, ob sich der Scanner zu erkennen gibt und sogar etwas scannt:<\/p>\n\n\n\n Raman Gupta hat mit „sane-scan-pdf<\/a>“ ein Script bereitgestellt, dass die ganze „harte Arbeit“ \u00fcbernimmt, die passenden Befehle zu verketten, um tats\u00e4chlich mehrere Seiten per automatischem Papiereinzug zu einer PDF zu verketten und eine OCR laufen zu lassen. Installieren l\u00e4sst es sich mit:<\/p>\n\n\n\n Nach kurzem Ausprobieren musste ich feststellen, dass das Script meine Scans ohne OCR mit „pnmtops“, einem Tool, dass aus dem PNM-Format PostScript Dateien erstellt, konvertiert wurde und dabei irgendwie auf der resultierenden Seite nicht korrekt positioniert wurde. Auch die Option „-nocenter“ brachte keine Abhilfe\u2026 ein Teil auf der Seite oben blieb abgeschnitten. Mit folgendem Script lief dann der ganze Scanvorgang wie am Schn\u00fcrchen:<\/p>\n\n\n\n Nat\u00fcrlich wollte ich die gescannten Dateien nicht lokal sondern auf einer SAMBA-Netzwerkfreigabe meines NAS ablegen. Dazu habe ich den Ordner „\/mnt\/scans“ erstellt:<\/p>\n\n\n\n Danach musste ich die Datei „\/home\/\/.credentials\/scanserver“ mit folgendem Inhalt erstellen:<\/p>\n\n\n\n Im Anschluss habe ich noch die Datei „\/etc\/fstab“ bearbeitet und folgende Zeile erg\u00e4nzt:<\/p>\n\n\n\n Danach mussten nur noch alle Laufwerke neu gemountet werden:<\/p>\n\n\n\n Auch im obenstehenden Script, das den Scanvorgang \u00fcbernimmt, habe ich dann als Zielverzeichnis die Netzwerkfreigabe und nicht l\u00e4nger das lokale Verzeichnis \u00fcbernommen.<\/p>\n\n\n\n Den Knopfdruck des Scanners abzufragen stellte sich dann als n\u00e4chste H\u00fcrde heraus. Auf dem herk\u00f6mmlichen Weg, n\u00e4mlich mit scanbd, lie\u00dfen sich die Buttons nicht abfragen, da der Scanner ihren Status nicht \u00f6ffentlich preisgibt.<\/p>\n\n\n\n Entsprechend habe ich folgende Anleitung<\/a> befolgt und versucht, es2button von Jan Ruethzu kompilieren und zu installieren. <\/p>\n\n\n\n Download von Github ins Home-Verzeichnis:<\/p>\n\n\n\n Kompilieren vorbereiten (hierbei wird auch die Source vom Treiber „epsonscan2“ heruntergeladen):<\/p>\n\n\n\n Kompilieren:<\/p>\n\n\n\n Debian-Package erstellen:<\/p>\n\n\n\n Die .deb-Datei findet sich dann in Die Quelle des Treibers hatte ich ja schon herunterladen lassen, diese musste ich mir nur noch an einen vern\u00fcnftigen Ort kopieren:<\/p>\n\n\n\n Im Anschluss konnte ich das Kompilieren\/Installieren vorbereiten, indem ich die ben\u00f6tigten Abh\u00e4ngigkeiten installiert habe:<\/p>\n\n\n\n Weiter ging es mit:<\/p>\n\n\n\n Das ging noch verh\u00e4ltnism\u00e4\u00dfig schnell (wenige Minuten), der folgende Prozess dauert dann allerdings in etwa eineinhalb bis zwei Stunden:<\/p>\n\n\n\n Danach konnte epsonscan2 installiert werden, das ging wieder recht schnell (wenige Minuten):<\/p>\n\n\n\n
Zudem schien mir die Adapter-Verbindung zwischen USB-A und Micro-USB (der kleine Raspberry Zero hat keinen gro\u00dfen USB-Port) nicht besonders zuverl\u00e4ssig zu funktionieren!<\/p>\n\n\n\nRaspberry Pi 3+<\/h2>\n\n\n\n
<\/figure>\n\n\n\nInstallation von SANE<\/h3>\n\n\n\n
sudo apt-get update\r\nsudo apt-get upgrade\r\nsudo apt install sane sane-utils scanbd git imagemagick -y<\/code><\/pre>\n\n\n\nsudo usermod -a -G scanner <BENUTZER><\/code><\/pre>\n\n\n\n# Listet alle USB-Ger\u00e4te\r\nlsusb\r\n\r\n# Sucht nach Scannern am USB-Bus\r\nsudo sane-find-scanner\r\n\r\n# Pr\u00fcft, ob der Scanner korrekt von SANE erkannt wurde\r\nsudo scanimage -L\r\n\r\n# Scannt ein Bild und leitet es in ein tempor\u00e4res Verzeichnis um. Wer hineinsehen will, kann dies an einem Rechner mit GUI unter GIMP tun.\r\nsudo scanimage >\/tmp\/out.pnm<\/code><\/pre>\n\n\n\nInstallation von sane-scan-pdf<\/h3>\n\n\n\n
cd $HOME\r\ngit clone https:\/\/github.com\/rocketraman\/sane-scan-pdf.git<\/code><\/pre>\n\n\n\n
Ein Workaround, der f\u00fcr mich (gut!) funktioniert, ist der Einsatz von „tesseract“ zur Texterkennung. Damit wird mein Scan korrekt dargestellt und durchsuchbar – exakt das, was ich wollte.<\/p>\n\n\n\n#!\/bin\/sh\n\nnow=date +\"%Y-%m-%d-%H%M\"\n\/home\/<BENUTZER>\/sane-scan-pdf\/scan -d -r 200 -v -m Color --device \"\" -xo \"-y 297.0\" --no-default-size --ocr --language deu -o \/home\/<BENUTZER>\/scans\/scan-$now.pdf<\/code><\/pre>\n\n\n\nScannen in einen Netzwerkordner<\/h3>\n\n\n\n
<\/figure>\n\n\n\nsudo mkdir \/mnt\/scans<\/code><\/pre>\n\n\n\nusername=<NAS-BENUTZER>\r\npassword=<FREIGABE-PASSWORT><\/code><\/pre>\n\n\n\n\/\/<IP-Adresse>\/scans \/mnt\/scans cifs user,credentials=\/home\/<BENUTZER>\/.credentials\/scanserver,iocharset=utf8,vers=2.0,_netdev,x-systemd.automount,x-systemd.after=network-online.target,noperm 0 0<\/code><\/pre>\n\n\n\nsudo mount -a<\/code><\/pre>\n\n\n\nscanbd Alternative – mein Scanner macht seine Buttons nicht \u00f6ffentlich zug\u00e4nglich<\/h3>\n\n\n\n
<\/figure>\n\n\n\ncd $HOME\ngit clone https:\/\/github.com\/janrueth\/es2button.git<\/code><\/pre>\n\n\n\ncd es2button\ncmake . -B build<\/code><\/pre>\n\n\n\nmake -C build<\/code><\/pre>\n\n\n\nmake -C build package<\/code><\/pre>\n\n\n\nbuild\/artifacts\/<\/code>. Sie konnte dann aber noch nicht installiert werden, denn hier sollte mir die Architektur des Rapsberry Pi mit Ubuntu (ARM64) einen Strich durch die Rechnung machen. Zwar lassen sich alle Abh\u00e4ngigkeiten in Form von Softwarepaketen installieren, gerade der ben\u00f6tigte Scanner-Treiber von Epson („epsonscan2“) ist aber nicht f\u00fcr diese Prozessorarchitektur kompiliert, was ich dann noch selbst \u00fcbernehmen musste. Zwei Stunden (ja, leider!) sollten f\u00fcr diesen Prozess einkalkuliert werden. Hier bin ich dieser Anleitung<\/a> von Epson selbst gefolgt. <\/p>\n\n\n\ncd $HOME\ncd es2button\/build\ncp epsonscan2-<VERSIONSNUMMER>.src.tar.gz ~\ntar -xvzf epsonscan2-<VERSIONSNUMMER>.src.tar.gz\nmv epsonscan2-<VERSIONSNUMMER>.src.tar.gz epsonscan2<\/code><\/pre>\n\n\n\ncd $HOME\ncd epsonscan2\n.\/install-deps<\/code><\/pre>\n\n\n\ncmake .<\/code><\/pre>\n\n\n\nmake<\/code><\/pre>\n\n\n\nsudo make install<\/code><\/pre>\n\n\n\n