scanbuttond
Dieser Artikel wurde für die folgenden Ubuntu-Versionen getestet:
Dieser Artikel ist mit keiner aktuell unterstützten Ubuntu-Version getestet! Bitte teste diesen Artikel für eine Ubuntu-Version, welche aktuell unterstützt wird. Dazu sind die Hinweise zum Testen von Artikeln zu beachten.
Artikel für fortgeschrittene Anwender
Dieser Artikel erfordert mehr Erfahrung im Umgang mit Linux und ist daher nur für fortgeschrittene Benutzer gedacht.
Zum Verständnis dieses Artikels sind folgende Seiten hilfreich:
Viele Scanner haben Tasten, mit denen sich Vorlagen direkt kopieren, faxen oder mailen lassen. Leider ist Software, die diese Tasten überwacht und nutzbar macht, in vielen Fällen nur für proprietäre Betriebssysteme verfügbar. scanbuttond 🇬🇧 hilft, diese Tasten auch unter Linux zu nutzen. Momentan werden Scanner von Epson, Canon, Agfa und HP unterstützt. Eine genaue Liste der jeweiligen Modelle findet man auf der Hardwareseite 🇬🇧 der Projektseite. Andere SANE-Scanprogramme haben dabei Vorrang, sie können gestartet werden, und unterbinden während ihres Betriebs die Tastenbedienung am Scanner.
Das Programm wird schon seit etlichen Jahre nicht mehr weiterentwickelt - die Dateien auf Sourceforge stammen aus 2006 - und unterstützt modernene Scanner nicht. Es gibt aber inzwischen einige Alternativen zu scanbuttond.
Installation¶
Das in den Quellen vorhandene Paket scanbuttond beinhaltet nur noch eine "Wrapper"-Skript, das scanbuttond-Skripte für die neuere Software scanbd verwendbar machen soll. Allerdings kann problemlos von ein Paket scanbuttond ⮷ von ubuntu.pkgs.org für Ubuntu 14.04 verwendet werden. Nach der Installation muss eine "Aktualisierung" z.B. via Apt-Pinning verhindert werden, da das Dummy-Paket eine höhere Versionsnummer hat und ansonsten umgehend von einem Update überschrieben wird.
Hinweis!
Fremdpakete können das System gefährden.
Konfiguration¶
Die benötigten Dateien initscanner.sh und buttonpressed.sh existieren zunächst nur als Beispieldateien (angehängtes ".example") im Verzeichnis /etc/scanbuttond. Um diese Dateien umzubenennen und zu bearbeiten, benötigt man Root-Rechte [2]. Nachdem man die beiden Konfigurationsdateien erstellt bzw. umbenannt hat, müssen diese noch ausführbar gemacht werden [3].
Damit der Scanner auch gefunden wird, muss in der neu erzeugten Datei /etc/scanbuttond/initscanner.sh der Befehl
sane-find-scanner
aktiviert werden [4].
Nun startet man im Terminal [5] scanbuttond per
scanbuttond -f
im Vordergrund. Wenn man jetzt die Tasten am Scanner drückt, sollte das Terminal eine Meldung ausgeben, die jeder gedrückten Taste eine eindeutige Nummer zuordnet. In etwa so:
button 1 has been pressed on plustek:libusb:002:005 button 2 has been pressed on plustek:libusb:002:005 button 3 has been pressed on plustek:libusb:002:005
Diese Zuordnung sollte man sich merken, sie wird später bei der Einrichtung der Aktionen noch gebraucht.
scanbuttond arbeitet mit Bash-Skripts, d.h. beim Drücken einer Scanner-Taste wird die Nummer der Taste an das Skript buttonpressed.sh im Verzeichnis /etc/scanbuttond/ übergeben. Das Skript startet dann abhängig von der Taste eine Aktion. Im Skript sieht das dann ungefähr so aus:
#!/bin/sh # This script[...]like scanimage. TMPFILE="/tmp/scan.tiff" LOCKFILE="/tmp/copy.lock" case $1 in 1) echo "button 1 has been pressed on $2" ;; 2) echo "button 2 has been pressed on $2" ;; 3) echo "button 3 has been pressed on $2" ;; 4) echo "button 4 has been pressed on $2" ;; esac
Zunächst gibt das Skript nur aus, welche Taste gedrückt wurde; dieses Verhalten gilt es zu ändern. Dazu öffnet man die Skript-Datei mit einem Texteditor [3] und trägt die gewünschten Kommandos an den entsprechenden Stellen anstatt des echo-Befehls ein, z.B. scanimage > bild.pnm
, um ein Dokument unter Verwendung der Standardeinstellungen einzuscannen und als bild.pnm zu speichern. Wenn nun die entsprechende Taste gedrückt wird, startet sofort die festgelegte Aktion, in diesem Fall das Speichern des Scans im eigenen Ordner.
Hinweis:
Sollte ein Scanner mehr als 4 Tasten besitzen, so kann man das Skript einfach erweitern, indem man weitere nummerierte Zeilen unter '4)' einfügt.
Experten-Info:
Anstatt die Kommandos direkt in buttonpressed.sh einzutragen, könnte man weitere Skripte aufrufen.
Hat man die gewünschten Änderungen getätigt, speichert man die Datei. Nun kann man noch im Autostart den Eintrag scanbuttond -f
hinzufügen und zukünftig nach jeder Anmeldung die programmierten Scannertasten sofort nutzen.
Skript-Beispiele¶
Hinweis:
Um diese Skripte nutzen zu können, müssen die Pakete
netpbm
libtiff-tools
Befehl zum Installieren der Pakete:
sudo apt-get install netpbm libtiff-tools
Oder mit apturl installieren, Link: apt://netpbm,libtiff-tools
installiert [1] sein.
Außerdem müssen die Skripte ausführbar[3] gemacht werden.
Ggf. sind nicht alle in den Skripten verwendeten Option für alle Scanner verwendbar - Auskunft darüber erhält man mit dem Aufruf von scanimage --help
.
Hier das für Skripte angepasste buttonpressed.sh sowie einige Beispiel-Skripte für Scannen, Kopieren und Mailen.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | #!/bin/sh TMPDIR="$HOME/Desktop" #hier wird ein Verzeichnis für die Datei festgelegt; durch die Verwendung der Umgebungsvariable $HOME wird jedesmal der Desktop des aktuellen Benutzers verwendet TMPFILE="$TMPDIR/scan`date +%Y%m%d`-`date +%H%M%S`" #wir generieren uns hier den Dateinamen für das spätere Ergebnis; der Name besteht aus dem Präfix scan und wird jedesmal um Datum und Uhrzeit ergänzt #Dateinamenerweiterungen werden später hinzugefügt LOCKFILE="/tmp/copy.lock" #Variable für das Lockfile, das kennzeichnet, ob der Scanner schon in Benutzung ist; wird hier nicht verwendet case $1 in 1) echo "Button 1 pressed" #wird Button 1 gedrückt so wird eine Meldung ausgegeben (nur sichtbar, wenn scanbuttond im Vordergrund läuft - zum Debuggen) $HOME/.scanscripts/scan.sh $TMPFILE $DEVICE #und das Skript scan.sh im versteckten Ordner .scanscripts im Homeverzeichnis gestartet; zusätzlich werden noch Name und Ort des Tempfiles, ;; #sowie die Adresse des Scanners übergeben, sinnvoll bei mehr als einem Scanner 2) echo "Button 2 pressed" #wird Button 2 gedrückt, so wird eine Meldung ausgegeben (siehe oben) $HOME/.scanscripts/copy.sh $TMPFILE $DEVICE #und das Skript copy.sh im versteckten Ordner .scanscripts im Homeverzeichnis gestartet; zu übergebenen Attributen siehe oben ;; 3) echo "Button 3 pressed" #wird Button 3 gedrückt, so wird eine Meldung ausgegeben (siehe oben) $HOME/.scanscripts/mail.sh $TMPFILE $DEVICE #und das Skript mail.sh im versteckten Ordner .scanscripts im Homeverzeichnis gestartet; zu übergebenen Attributen siehe oben ;; esac |
Hier das Skript zum einfachen Scannen (scan.sh)
1 2 3 4 5 6 7 8 9 10 | #!/bin/sh TMPFILE=$1 #Enthält zukünftigen Speicherort und Dateiname des Scans scanimage --format pnm --mode Color --depth 8 --resolution 300 -l 0 -t 0 -x 215mm -y 280mm --lampoff-time 300 > ${TMPFILE}.pnm #scanimage scannt die Vorlage und speichert sie als Dateiname.pnm, #die einzelnen Optionen sind von Scanner zu Scanner unterschiedlich (hier Farbscan #in einer Auflösung von 300dpi) pnmtojpeg -quality 85 -optimize -comment "was immer man als Kommentar haben will" $TMPFILE.pnm > $TMPFILE.jpeg # die .temp-Datei wird mittels pnmtojpeg in eine jpeg-Datei umgewandelt und dabei komprimiert rm -f $TMPFILE.pnm #jetzt muss nur noch die temporäre Datei gelöscht werden |
Und hier zum Kopieren (copy.sh)
1 2 3 4 5 6 7 8 | #!/bin/sh TMPFILE=$1 #siehe Skript zum Scannen scanimage --format tiff --mode Gray --resolution 300 --brightness -3 -l 0 -t 0 -x 215mm -y 297mm > ${TMPFILE}.tiff #scannt das Bild ein und speichert es als tiff (hier in Graustufen und Auflösung 300dpi) tiff2ps -z -w 8.27 -h 11.69 $TMPFILE.tiff | lpr # eingescanntes Bild wird in Postscript umgewandelt und an den Standarddrucker gesendet rm -f $TMPFILE.tiff #temporäre Datei wird gelöscht |
Zum Schluss noch eines zum Versenden per Mail (mail.sh):
1 2 3 4 5 6 7 8 9 10 11 | #!/bin/sh TMPFILE=$1 #siehe Skript zum Scannen scanimage --format pnm --mode Color --depth 8 --resolution 300 -l 0 -t 0 -x 215mm -y 280mm --lampoff-time 300 > ${TMPFILE}.pnm #scannt das Bild ein und speichert es als pnm pnmtojpeg -quality 85 -optimize -comment "was immer man als Kommentar haben will" $TMPFILE.pnm > $TMPFILE.jpeg #wandelt das Bild von pnm zu jpeg um rm -f ${TMPFILE}.pnm #temporäre Datei wird gelöscht #hier wird Evolution zum Versenden eingesetzt evolution --display=:0.0 "mailto:?attach=$TMPFILE.jpeg" #öffnet Evolutions Maileditor und fügt das Bild als Anhang hinzu |
Falls scanbuttond nicht über einen Eintrag in die rc.local gestartet wurde, sondern der Dienst über die /etc/default/scanbuttond-Datei aktiviert wurde, kann es beim mail-Skript zu folgender Fehlermeldung kommen:
Cannot start Evolution. Another Evolution instance may be unresponsive. System Error: Cannot autolaunch D-Bus without X11 $DISPLAY
Abhilfe schafft es ggf., in der letzte Zeile Evolution mit folgendem Befehl aufzurufen:
$(DISPLAY=:0 evolution "mailto:?attach=$TMPFILE.jpeg")
PDF mit Textlayer¶
Um eine PDF-Datei mit Textlayer zu erstellen (verwendet wird OCRmyPDF) kann folgendes Skript (z.B. als pdf.sh) verwendet werden, was man zweckmäßigerweise mit dem PDF-Knopf am Scanner aufruft (dazu das buttonpressed.sh entsprechend erweitern):
1 2 3 4 5 6 7 8 9 10 | #!/bin/sh TMPFILE=$1 #siehe Skript zum Scannen scanimage --format tiff --mode Gray --resolution 300 -l 0 -t 0 -x 210mm -y 297mm > ${TMPFILE}.tiff #scannt das Bild ein und speichert es als tiff (hier in Graustufen und Auflösung 300dpi) tiff2pdf -o ${TMPFILE}.pdf ${TMPFILE}.tiff # eingescanntes Bild wird in Pdf umgewandelt und an ocrmypdf übergeben ocrmypdf -l deu -C no_ligature ${TMPFILE}.pdf ${TMPFILE}.OCR.pdf rm -f $TMPFILE.tiff #temporäre Datei wird gelöscht rm -f $TMPFILE.pdf #temporäre PDF-Datei wird gelöscht |
Mehrfachbelegung von Tasten¶
Mit etwas Puzzlearbeit ist es möglich, die Tasten des Scanners mit mehreren Funktionen zu belegen. Im folgenden Beispiel wird die Copy-Taste mit den Funktionen S/W-Kopie (ein Tastendruck), Graustufen-Kopie (zwei Tastendrücke) und Farb-Kopie (drei Tastendrücke) belegt. Bei mehr als drei Tastendrücken innerhalb einer Zeitraumes von 5 Sekunden (anpassbar in Zeile 3) wird eine Fehlermeldung ausgegeben. Das hier vorgestellte Beispiel arbeitet mit yad und usbreset, um ggf. Fehler bei der Scannerfreigabe zu kompensieren. Das Skript sollte statt über einen Autostart-Eintrag in rc.local über die Datei /etc/default/scanbuttond gestartet werden, in der neben RUN=yes
auch RUN_AS_USER=BENUTZER
eingetragen werden sollte. In /etc/init.d/scanbuttond ebenfalls den Benutzer ändern, außerdem in Zeile DAEMON_OPTS=
den Wert "-p 10000"
eintragen (damit wird das Zeitintervall angegeben, wie oft scanbuttond überprüft, ob neue Tastendrücke erfolgt sind).
Zur Verwendung wird in /etc/scanbuttond/buttonpressed.sh folgender Eintrag für die entsprechende Taste abgespeichert:
echo "Button 1 pressed - copy" >> /tmp/scanbutton.log 2<&1 #wird Button 1 gedrückt so wird eine Meldung ausgegeben (nur sichtbar, wenn scanbuttond im Vordergrund läuft - zum Debuggen, hier wird in die Log-Datei geschrieben) PID_FILE=/tmp/scanbutton.pid if [ -e $PID_FILE ]; then kill -SIGUSR1 $(<"$PID_FILE") 2>&1 |: #>> /tmp/scanbutton.log else rm -f /tmp/scanbutton.log nohup /PFAD/ZUM/.scanscripts/copy_counter.sh $TMPFILE $DEVICE >> /tmp/scanbutton.log 2<&1 < /dev/null & fi
Das Skript muss ggf. als bash-Skript gespeichert werden, dazu die shebang auf #!/bin/bash
ändern. Den Pfad zum copy_counter.sh-Skript entsprechend anpassen.
Das Skript selbst in einen Editor kopieren und als copy_counter.sh abspeichern und ausführbar machen:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 | #!/bin/bash TIMEOUT=5 # count button presses after n seconds and take appropriate actions PID_FILE=/tmp/scanbutton.pid echo $$ > $PID_FILE # create a file with our pid declare -a BTN_PRESSED BTN_PRESSED+=($(date +%s)) function cleanup { rm -f "$PID_FILE" } function check_runtime { if [[ ${BTN_PRESSED[0]} -lt $(date +%s -d "$TIMEOUT seconds ago") ]]; then return 1 # the oldest timestamp is older than $TIMEOUT else return 0 fi } # reset usb-connection function usbrestart { usbreset /dev/bus/usb/002/004 2>&1 >> /tmp/scanbutton.log } #scan image function scan_color { if [[ "$SCANCOLOR" == "BW" ]]; then scanimage --format pnm --mode Lineart --custom-gamma=yes --gamma-table 30000 --resolution 300 -l 0 -t 0 -x 210mm -y 297mm > ${TMPFILE}.pnm 2> /tmp/scanimage.txt elif [[ "$SCANCOLOR" == "GR" ]]; then scanimage --format pnm --mode Gray --swcrop=yes --swdeskew=no --custom-gamma=yes --gamma-table 30000 --resolution 300 -l 0 -t 0 -x 210mm -y 297mm > ${TMPFILE}.pnm 2> /tmp/scanimage.txt elif [[ "$SCANCOLOR" == "CL" ]]; then scanimage --format pnm --mode Color --swcrop=no --resolution 300 -l 0 -t 0 -x 210mm -y 297mm > ${TMPFILE}.pnm 2> /tmp/scanimage.txt fi } #print image function print_tiff { lpr ${TMPFILE}.pnm echo "Scan sent to printer, ~~~`date +%Y%m%d`-`date +%H%M%S`" rm -f ${TMPFILE}.pnm #2>&1 > /dev/null |: #temporäre Datei wird gelöscht } # check if SANE-decive is usable, if not reset usb-device and restart the whole process function check_device { CHECK=`cat "/tmp/scanimage.txt"` if [[ $CHECK != "" ]] ; then $(DISPLAY=:0 yad --on-top --center --timeout=5 --title="Device problem..." --text="Ooops - problems with the scanner! \nScript trys to reset usb connection!") echo "device problem `date +%Y%m%d`-`date +%H%M%S`" echo "$CHECK" usbrestart scan_color echo "Scan completed, ~~~`date +%Y%m%d`-`date +%H%M%S`" print_tiff rm -f /tmp/scanimage.txt exit 0 fi } trap 'cleanup; exit 0' SIGTERM SIGINT trap cleanup EXIT trap "BTN_PRESSED+=($(date +%s));" SIGUSR1 while check_runtime; do sleep 0.11 # if the button presses have a shorter delta t, then reduce this value done echo "~~~`date +%Y%m%d`-`date +%H%M%S`" echo "Button has been pressed at ${BTN_PRESSED[@]}" case ${#BTN_PRESSED[@]} in 1) echo "action #1, b/w-copy A4" TMPFILE=$1 SCANCOLOR=BW scan_color check_device echo "Scan completed, ~~~`date +%Y%m%d`-`date +%H%M%S`" print_tiff ;; 2) echo "action #2 Grayscale-copy A4" TMPFILE=$1 SCANCOLOR=GR scan_color check_device echo "Scan completed, ~~~`date +%Y%m%d`-`date +%H%M%S`" print_tiff ;; 3) echo "action #3, Color-copy A4" TMPFILE=$1 SCANCOLOR=CL scan_color check_device echo "Scan completed, ~~~`date +%Y%m%d`-`date +%H%M%S`" print_tiff ;; *) echo "too many button presses" esac rm -f /tmp/scanimage.txt |
Jetzt sollte bei entsprechenden Tastendrücken direkte Kopien im Din-A4-Format entstehen. Das Skript ist für einen CanoScan LiDE 60 ausgelegt, ggf. müssten einige Optionen an die Gegebenheiten des eigenen Scanners angepasst werden. Fehlermeldungen werden in der .log-Datei /tmp/scanbutton.log aufgeführt. Falls der Scanner nicht erkannt wird, versucht das Skript, den USB-Anschluss via usbreset neu zu starten und den Auftrag zu wiederholen - yad öffnet dazu ein Hinweisfenster.
Besonderer Dank geht an seahawk1986, der maßgeblich an der Entwicklung beteiligt war, siehe dazu auch diesen Thread im Forum.
Alternativen¶
Tasten am Scanner verwenden - Übersicht
scanbd - modernere Alternative für SANE-fähige Scanner.
insaned - einfaches Programm, um Tasten zu verwenden, ohne Anspruch auf gleichzeitige anderweitige Nutzung des Scanners.
bscand - ein Programm, das durch eine gepatchte SANE-backend-Version die Tasten direkt zugänglich macht; verwendet das net-backend.
Für Brother-Scanner kann das Programm Scankey-Tool verwendet werden.
Links¶
Projektseite 🇬🇧
scanbd 🇬🇧 - jüngere Alternative zu scanbuttond
Gentoo-Wiki-Eintrag 🇬🇧 in dem u.a. ein Weg beschrieben wird, nicht unterstützte Scanner mit aufzunehemn; dazu muss allerdings der sourcecode bearbeitet, und das Programm selbst kompiliert werden.