Installation¶

sudo apt-get install scanbd 

sudo apt-get install libconfuse-dev libdbus-1-dev libsane-dev libusb-dev pkg-config libsane-dev libudev-dev 

Funktionsweise¶

Um die Impulse erkennen zu können, öffnet scanbd das Gerät und blockiert so den Scanner für andere Anwendungen. Um dieses Problem zu umgehen, wird ein weiterer Daemon eingesetzt, der für die Zeit, in der anderweitig auf den Scanner zugegriffen werden soll, das Polling unterbricht. Dazu wird scanbm (der "Manager-Modus" von scanbd) statt saned als Netzwerk-Daemon verwendet. Er wird quasi als "Proxy" eingesetzt, der ein dbus-Signal an scanbd sendet, wenn andere Anfragen eingehen. Daraufhin wird der reguläre saned-Dienst eingesetzt, um einen Scan zu starten und die Ergebnisse an die anfragende Anwendung zu senden. Danach übernimmt wieder scanbm und sendet scanbd den Auftrag, das Polling wieder aufzunehmen.

Um das zu ermöglichen, müssen die Standard-Einstellungen für SANE so angepasst werden, dass von scanbd gestartete Scanner-Anwendungen auf den lokal angeschlossenen Scanner über das net-backend zugreifen können.

Scanner-Tasten¶

Ob die Tasten am Scanner erkannt werden sollten, kann im Terminal^[2] mit dem Aufruf von scanimage -A überprüft werden. Die erkannten Tasten ("Sensors") werden am Ende der Ausgabe aufgeführt, für einen Canon LiDE 220 sind das z.B. Folgende:

All options specific to device `genesys:libusb:003:005':
  Scan Mode:
...
  Sensors:
    --scan[=(yes|no)] [no] [hardware]
        Scan button
    --file[=(yes|no)] [no] [hardware]
        File button
    --email[=(yes|no)] [no] [hardware]
        Email button
    --copy[=(yes|no)] [no] [hardware]
        Copy button
    --extra[=(yes|no)] [no] [hardware]
        Extra button
  Buttons:
    --clear-calibration
        Clear calibration cache

Bei einem CanoScan N670U sind die Tasten unter "Buttons" zu finden:

All options specific to device `net:debian.fritz.box:plustek:libusb:001:003':
[...]
  Buttons:
    --button 0[=(yes|no)] [no] [hardware]
        This option reflects the status of the scanner buttons.
    --button 1[=(yes|no)] [no] [hardware]
        This option reflects the status of the scanner buttons.
    --button 2[=(yes|no)] [no] [hardware]
        This option reflects the status of the scanner buttons.
    --button 3[=(yes|no)] [inactive]
        This option reflects the status of the scanner buttons.
    --button 4[=(yes|no)] [inactive]
        This option reflects the status of the scanner buttons.

Funktionstest¶

Um nähere Informationen darüber zu erlangen, welche Tasten scanbd erkennt, kann zunächst im Terminal ein Aufruf mit dem Befehl

scanbd -f -d7 

erfolgen. Dazu muss der SANE-Daemon ausgeschaltet sein (mit sudo systemctl stop saned.socket) und es darf keine weitere scanbd Instanz laufen ('sudo systemctl stop scanbd.service' wenn der Dienst vorher gestartet wurde), sonst erkennt scanbd keine Scanner. Mit dem Befehl läuft scanbd im Vordergrund im höchsten "debugging"-Level, im Terminal erscheinen zunächst die Angaben zum Gerät sowie Ergebnisse die Standard-Filter-Abfragen, die in der scandb.conf vorgesehen sind, so z.B.

scanbd: checking action scan with filter: ^scan.*
...
scanbd: checking action email with filter: ^email$
...
scanbd: checking action copy with filter: ^copy$
...

Danach erfolgt das Logging der Abfragen für die gefundenen Optionen, z.B. etwas wie

scanbd: Start the polling for device genesys:libusb:003:005
scanbd: polling thread for genesys:libusb:003:005, before cancellation point
scanbd: polling thread for genesys:libusb:003:005, after cancellation point
scanbd: polling device genesys:libusb:003:005
scanbd: get_sane_option_value
scanbd: checking option preview number 4 (0) for device genesys:libusb:003:005: value: 0

Beim Drücken einer der Tasten sollte sich die value-Angabe in der letzten Zeile auf den Wert 1 ändern, wenn diese Option durch eine der Tasten ausgelöst wird. Wenn beim Tastendruck keine Veränderung erfolgt, werden die Tasten von scanbd nicht erkannt. Ggf. muss sichergestellt werden, dass die Filter in scandb.conf bzw. in der evtl. darin includierten Scannerspezifischen Konfiguratiosdatei aus ./scanner.d/ den Bezeichnungen der Scanner-Tasten aus scanimage -A entsprechen (s. Konfiguration).

'scanbd: SANE_CONFIG_DIR not set'

SANE_CONFIG_DIR=/etc/scanbd scanbd -f -d7 

Konfiguration¶

scanbd ist voll mit systemd kompatibel, und benötigt keine Dienste, um den Dienst scanbm zu starten. Diese Möglichkeit existiert weiterhin und kann bei Bedarf verwendet werden (wird hier nicht ausgeführt, siehe aber z.B. diese Anleitung 🇩🇪 auf bbb.archlinux.de).

# saned lokal, langer timeout unnoetig
connect_timeout = 3
# scanbm lauscht an localhost
localhost

sudo systemctl edit --full NAME_DER_UNIT_DATEI 

        action extras {
                filter = "^extra$"
                string-trigger {
                        from-value  = ""        
                        to-value    = "^extra.*"
                }
                desc   = "whatever" # frei wählbar
                # script must be an relative path starting from scriptdir (see above), 
                # or an absolute pathname. 
                # It must contain the path to the action script without arguments
                # Absolute path example: script = "/some/path/foo.script 
                script = "test.script"
        }

device plustek {
        
        # the device matching string
        filter = "^plustek.*"

        # the device description
        desc = "Plustek Scanner"

        # device specific actions
        # (overriding previously defined matching actions)
        action email {
                filter = "^button 0.*"
                numerical-trigger {
                  from-value = 1
                  to-value   = 0
                }
                desc   = "Scan to e-mail"

                # script must be an relative path starting from scriptdir (see above), 
                # or an absolute pathname. 
                # It must contain the path to the action script without arguments
                # Absolute path example: script = "/some/path/foo.script 
                script = "test.script"
        }
        action copy {
                filter = "^button 1.*"
                numerical-trigger {
                  from-value = 1
                  to-value   = 0
                }
                desc   = "Scan to printer"

                # script must be an relative path starting from scriptdir (see above), 
                # or an absolute pathname. 
                # It must contain the path to the action script without arguments
                # Absolute path example: script = "/some/path/foo.script 
                script = "test.script"
        }
        action scan {
                filter = "^button 2.*"
                numerical-trigger {
                  from-value = 1
                  to-value   = 0
                }
                desc   = "Scan to file"

                # script must be an relative path starting from scriptdir (see above), 
                # or an absolute pathname. 
                # It must contain the path to the action script without arguments
                # Absolute path example: script = "/some/path/foo.script 
                script = "test.script"
        }
}

ExecStart=/usr/local/sbin/scanbm -c /usr/local/etc/scanbd/scanbd.conf #scanbm@.service

ExecStart=/usr/local/sbin/scanbd -f -c /usr/local/etc/scanbd/scanbd.conf #scanbd.service
...
Environment=SANE_CONFIG_DIR=/usr/local/etc/scanbd/sane.d #beide Dateien

sudo systemctl disable saned.socket 

sudo systemctl enable scanbd.service # zur automatischen Ausführung beim Systemstart nötig
sudo systemctl start scanbd.service
sudo systemctl enable scanbm.socket # zur automatischen Ausführung beim Systemstart nötig
sudo systemctl start scanbm.socket 

ss -anp|grep 6566 

tcp    LISTEN     0      128       *:6566                  *:*                   users:(("inetd",pid=569,fd=7))

sudo systemctl stop inetd.service
sudo systemctl disable inetd.service 

Tasten mit Funktionen belegen¶

Um die Tasten dann mit Funktionen wie Scannen, Fotokopie erstellen, Email etc. zu belegen, in der scanbd.conf die Einträge, die im Auslieferungszustand auf test.script verweisen, entsprechend anpassen In (...)/etc/scanbd(/scripts) bzw. /usr/share/scanbd/scripts/ finden sich Vorlagen, die den eigenen Bedingungen angepasst werden können.

Bei Rechteproblemen kann es hilfreich sein sein, die zu verwendenden Skripte in einen Ordner im Homeverzeichnis zu verlegen legen, dazu dann die Angabe zum Skriptspeicherort (Standard /etc/scanbd/scripts) entsprechend anpassen.

xhost +si:localuser:root 

Ein Skript zur Erstellung eines PDFs mit Texterkennung via OCRmyPDF könnte so aussehen:

1
2
3
4
5
6

scanimage --format tiff --mode Gray --resolution 300 -l 0 -t 0 -x 210mm -y 297mm > /home/BENUTZER/scanbd.tiff#scannt das Bild ein und speichert es als tiff (hier in Graustufen und Auflösung 300dpi)

tiff2pdf -o /home/BENUTZER/scanbd.pdf /home/BENUTZER/scanbd.tiff # eingescanntes Bild wird in Pdf umgewandelt und an ocrmypdf übergeben
export LANG=C.UTF-8
export LC_ALL=C.UTF-8
ocrmypdf -q --pdf-renderer hocr -l deu /home/BENUTZER/scanbd.pdf /home/BENUTZER/scanbdhocr.OCR.pdf

Weitere Informationen und Beispiele zu derartigen Skripten finden sich im Artikel scanbuttond (Abschnitt „Skript-Beispiele“).

Die Durchführung der Skripte startet bei Verwendung der Version aus den Quellen ggf. mit einer erheblichen Zeitverzögerung (bis zu 30 Sekunden), also etwas Geduld haben, eine selbsterstellte Version startet wesentlich schneller. Im Terminal kann in der Ausgabe von

systemctl status scanbd.service 

überprüft werden, ob der Befehl umgesetzt wir, oder es ggf. zu Fehlern bei der Abarbeitung des Skriptes kommt - ggf. zunächst keine "Quiet"-Einstellungen bei den Programmen verwenden, die Meldungen werden dann mit angezeigt.

Probleme und Lösungen¶

systemctl status scanbd.service 

● scanbd.service - Scanner button polling Service
   Loaded: loaded (/lib/systemd/system/scanbd.service; enabled; vendor preset: enabled)
   Active: active (running) since Do 2018-03-29 18:52:55 CEST; 57s ago
 Main PID: 5428 (scanbd)
   CGroup: /system.slice/scanbd.service
           └─5428 /usr/sbin/scanbd -f

Mär 29 18:52:55 Rechenername systemd[1]: Started Scanner button polling Service.
Mär 29 18:52:55 Rechenername scanbd[5428]: /usr/sbin/scanbd: dbus match type='signal',interface='org.freedesk

systemctl status scanbm.socket 

● scanbm.socket - scanbd/saned incoming socket
   Loaded: loaded (/lib/systemd/system/scanbm.socket; enabled; vendor preset: enabled)
   Active: active (listening) since Do 2018-03-29 18:53:15 CEST; 12min ago
   Listen: [::]:6566 (Stream)
 Accepted: 25; Connected: 1

Mär 29 18:53:15 Rechenername systemd[1]: Listening on scanbd/saned incoming socket.

systemctl status scanbm@*.service 

● scanbm@3-127.0.0.1:6566-127.0.0.1:53122.service - Scanner Service (127.0.0.1:53122)
   Loaded: loaded (/lib/systemd/system/scanbm@.service; static; vendor preset: enabled)
   Active: active (running) since Sun 2019-04-28 08:58:34 CEST; 37s ago
 Main PID: 6435 (scanbm)
    Tasks: 3 (limit: 4915)
   CGroup: /system.slice/system-scanbm.slice/scanbm@3-127.0.0.1:6566-127.0.0.1:53122.service
           ├─6435 /usr/local/sbin/scanbm -c /usr/local/etc/scanbd/scanbd.conf
           └─6436 saned

Apr 28 08:58:34 RECHNERNAME systemd[1]: Started Scanner Service (127.0.0.1:53122).
Apr 28 08:58:34 RECHNERNAME scanbm[6435]: /usr/local/sbin/scanbm: dbus match type='signal',interface='org.freedesktop.
Apr 28 08:58:34 RECHNERNAME saned[6436]: saned (AF-indep+IPv6) from sane-backends 1.0.27git starting up
Apr 28 08:58:34 RECHNERNAME saned[6436]: check_host: access by remote host: ::ffff:127.0.0.1
Apr 28 08:58:34 RECHNERNAME saned[6436]: init: access granted to BENUTZER@::ffff:127.0.0.1

1
2
3
4
5
6

#!/bin/bash
sleep 60
while pidof saned true
   do
sleep 30
done

1
2
3
4
5

#!/bin/bash
export DISPLAY=:0
export LANG=de_DE.UTF-8
export LC_ALL=de_DE.UTF-8
xsane

Alternativen¶

• Tasten am Scanner verwenden - Übersicht

  • insaned - einfacheres Programm zum Einsatz der Scanner-Knöpfe, das allerdings auch nicht den Anspruch hat, den Scanner anderweitig zu verwenden.

  • bscand - ein Programm, das über eine gepatchte SANE-backend-Version die Tasten direkt zugänglich macht; SANE-Programme bleiben voll einatzfähig, verwendet dazu das net-backend.

• Links¶

• Scanner -Übersichtsartikel

• Scanner Button Daemon 🇬🇧 - Artikel im Arch-Wiki

  • Anleitung mit xined 🇩🇪 aus bss.archlinux.de

• Älterer Beitrag 🇬🇧, ebenfalls nicht für systemd

• scanbd 🇩🇪 - Blogbeitrag auf adlerweb.info

• Hinweis auf xhost-Verwendung 🇬🇧