[[Vorlage(Getestet, bionic)]]
[[Vorlage(Fortgeschritten)]]
{{{#!vorlage Wissen
[:Pakete_installieren:Installation von Programmen]
[:sudo: Root-Rechte]
[:Rechte: Rechte für Dateien und Ordner ändern]
[:Editor: Einen Editor öffnen]
[:Terminal: Ein Terminal öffnen]
}}}
[[Inhaltsverzeichnis(2)]]
[[Bild(Wiki/Icons/scanner.png, 48, left)]]
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. [sourceforge2:scanbuttond:] {en} hilft, diese Tasten auch unter Linux zu nutzen. Momentan werden Scanner von [:Scanner/Epson:Epson], [:Scanner/Canon:Canon], [:Scanner/Agfa_SnapScan:Agfa] und [:HPLIP:HP] unterstützt. Eine genaue Liste der jeweiligen Modelle findet man auf der [http://scanbuttond.sourceforge.net/index.php?page=/Supported_Scanners.php Hardwareseite] {en} 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 [:Scanner/Software/#Tasten-am-Scanner-verwenden: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 [https://ubuntu.pkgs.org/14.04/ubuntu-universe-amd64/scanbuttond_0.2.3.cvs20090713-16_amd64.deb.html scanbuttond] {dl} 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.
[[Vorlage(Fremd, Paket, "")]]
= 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
{{{#!vorlage Befehl
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.
{{{#!vorlage 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.
}}}
{{{#!vorlage Experten
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 =
{{{#!vorlage Hinweis
Um diese Skripte nutzen zu können, müssen die Pakete
{{{#!vorlage Paketinstallation
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.
{{{#!code bash
#!/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''')
{{{#!code bash
#!/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''')
{{{#!code bash
#!/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'''):
{{{#!code bash
#!/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):
{{{#!code bash
#!/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:
{{{#!code bash
#!/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 [user:seahawk1986:], der maßgeblich an der Entwicklung beteiligt war, siehe dazu auch diesen [topic:scanner-tastendruecke-in-einem-bestimmten-zeit:Thread] im Forum.
= Alternativen =
* [:Scanner/Software/#Tasten-am-Scanner-verwenden:Tasten am Scanner verwenden] {Übersicht} - Ü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 [:Scanner/Brother/Scankey-Tool:Scankey-Tool] verwendet werden.
= Links =
* [sourceforge2:scanbuttond:Projektseite] {en}
* [sourceforge2:scanbd:] {en} - jüngere Alternative zu scanbuttond
* [http://wikigentoo.ksiezyc.pl/Scanner_buttons_and_one-touch_scanning.htm Gentoo-Wiki-Eintrag] {en} 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.
# tag: Hardware, Scanner