Ubuntu 14.04 Trusty Tahr
Ubuntu 12.04 Precise Pangolin
Dieser Artikel erfordert mehr Erfahrung im Umgang mit Linux und ist daher nur für fortgeschrittene Benutzer gedacht.
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. Für Brother-Geräte und die KDE-Oberfläche gibt es auch Alternativen zu Scanbuttond.
Zuerst muss das folgende Paket installiert [1] werden:
scanbuttond (universe)
mit apturl
Paketliste zum Kopieren:
sudo apt-get install scanbuttond
sudo aptitude install scanbuttond
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
Momentan gibt das Skript nur aus, welche Taste gedrückt wurde; dieses Verhalten gilt es nun 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.
Sollte ein Scanner mehr als 4 Tasten besitzen, so kann man das Skript einfach erweitern, indem man weitere nummerierte Zeilen unter '4)' einfügt.
Anstatt die Kommandos direkt in buttonpressed.sh einzutragen, könnte man weitere Skripte aufrufen. Siehe dazu auch die weiterführende Anleitung im Gentoo-Wiki
Hat man die gewünschten Änderungen getätigt, speichert man die Datei. Nun kann man noch unter "System -> Einstellungen -> Startprogramme" den Eintrag scanbuttond -f
hinzufügen und zukünftig nach jeder Anmeldung die programmierten Scannertasten sofort nutzen.
Um diese Skripte nutzen zu können, müssen die Pakete
netpbm
libtiff-tools
mit apturl
Paketliste zum Kopieren:
sudo apt-get install netpbm libtiff-tools
sudo aptitude install 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")
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 |
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/buttonprresed.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, der in Ubuntu 14.04 Trusty Tahr unter SANE-1.0.25 läuft, 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.
Erweiterter Hardware Support für älterer Ubuntu-Versionen (unter anderem auch für die HP 39xx Serie) ist in der Version scanbuttond_0.2.3.cvs20090713-1 vorhanden. Ab Ubuntu 14.04 ist schon eine aktuellere Version von scanbuttond in den offiziellen Quellen.
Repository-Link: Paketquelle
In der Dokumentation die Quellen der enthaltenen Treiber.
Sollten beim Einsatz der scanbuttond_0.2.3.cvs20090713-1 Version folgende Fehlermeldungen im syslog auftauchen:
scanbuttond: libusbi: could not claim interface for device 003:004. (code=-1) scanbuttond: scanbtnd_open failed, error code: -19
muss in der Datei /etc/default/scanbuttond der Eintrag RUN_AS_USER=saned
zu RUN_AS_USER=root
geändert werden.
Für Brother-Scanner kann das Programm Scankey-Tool verwendet werden
KScannerButtons - Eine Alternative für KDE
scanbd - jüngere Alternative zu scanbuttond
scanbuttond and CanoScan LiDE 110/120 Erklärung, wie scanbuttond um neue Scanner ergänzt werden kann.
Diese Revision wurde am 21. November 2015 15:26 von aasche erstellt.