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.

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.

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¶

sudo apt-get install netpbm libtiff-tools 

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")

 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.