⌨️Befehle & Praxis

scanimage -L

Ruft sane_init() und sane_get_devices() auf und gibt jedes Gerät mit Namen, Hersteller, Modell und Typ aus. Den Namen in Backticks braucht man für -d.

device `test:0' is a Noname frontend-tester virtual device
device `test:1' is a Noname frontend-tester virtual device
device `net:scanner.example.org:test:0' is a Noname frontend-tester virtual device
device `airscan:e0:Beispiel MFP 400' is a eSCL Beispiel MFP 400 ip=192.0.2.40

scanimage -f "%i: %d (%v %m, %t)%n"

Platzhalter: %d Gerätename, %v Hersteller, %m Modell, %t Typ, %i laufende Nummer, %n Zeilenumbruch – praktisch für Skripte.

0: test:0 (Noname frontend-tester, virtual device)
1: test:1 (Noname frontend-tester, virtual device)

sudo sane-find-scanner -q

Sucht unabhängig von den Backends nach Geräten, die wie Scanner aussehen, und zeigt Hersteller- und Produkt-ID. Findet es den Scanner, aber scanimage -L nicht, fehlt meist das Backend oder die Berechtigung. Netzwerk-Scanner findet es nicht.

found USB scanner (vendor=0x1234, product=0x5678) at libusb:001:007

scanimage -d test:0 -A

Listet alle Optionen, die das Backend über sane_get_option_descriptor() meldet, mit erlaubten Werten und [Standardwert]. -l/-t sind tl-x/tl-y, -x/-y sind Breite und Höhe.

All options specific to device `test:0':
  Scan Mode:
    --mode Gray|Color [Gray]
    --depth 1|8|16 [8]
    --resolution 1..1200dpi (in steps of 1) [50]
    --source Flatbed|Automatic Document Feeder [Flatbed]
  …
  Geometry:
    -l 0..200mm (in steps of 1) [0]
    -t 0..200mm (in steps of 1) [0]
    -x 0..200mm (in steps of 1) [80]
    -y 0..200mm (in steps of 1) [100]
(gekürzt)

scanimage -d 'test:0' --mode Color --resolution 300 --format=png -o scan.png

Setzt mode und resolution per sane_control_option(), startet, liest bis EOF und schreibt PNG. Ohne --format gibt scanimage PNM auf die Standardausgabe aus.

scanimage -d 'test:0' -l 10 -t 20 -x 100 -y 50 --format=tiff -o ausschnitt.tif

10 mm von links, 20 mm von oben, 100 × 50 mm groß. Beim test-Backend mit 50 dpi ergibt das 196 × 98 Pixel (abgeschnitten wie im Backend).

scanimage -d 'test:0' --resolution 600 -p --format=png -o gross.png

-p zeigt den Fortschritt in Prozent – berechnet aus den über sane_read() gelesenen Bytes im Verhältnis zu bytes_per_line × lines.

Progress: 37.4%

scanimage -d 'test:0' --source 'Automatic Document Feeder' --batch=seite%03d.png --format=png --resolution 300

Ruft sane_start() in einer Schleife, bis SANE_STATUS_NO_DOCS kommt, und schreibt seite001.png, seite002.png … Der Name der Quelle hängt vom Backend ab (z. B. ADF, ADF Duplex) – siehe -A. Das test-Backend meldet den Einzug nach 10 Seiten als leer.

Scanning page 1
Scanned page 1. (scanner status = 5)
Scanning page 2
…
Scanning page 11
scanimage: sane_start: Document feeder out of documents

scanimage --source ADF --batch=s%02d.png --batch-start=1 --batch-double --format=png

--batch-double zählt die Dateinummer um 2 hoch: erst alle Vorderseiten (1, 3, 5 …), dann Stapel umdrehen und mit --batch-start=2 die Rückseiten.

scanimage --batch=seite%d.png --batch-prompt --format=png

Wartet vor jeder Seite auf die Eingabetaste – für Flachbettscanner ohne Einzug.

scanimage -d test:0 -T

Führt einige Plausibilitätstests der API aus – vor allem sane_read() mit verschiedenen Puffergrößen.

sudo apt install sane-utils
sudoedit /etc/sane.d/saned.conf     # erlaubtes Netz eintragen, z. B. 192.0.2.0/24
sudo systemctl enable --now saned.socket

saned wird über die systemd-Socket-Unit gestartet: systemd lauscht auf Port 6566 und startet je Verbindung eine Instanz saned@.service als Benutzer saned. Nur Hosts/Netze aus saned.conf dürfen scannen, localhost immer.

echo 'scanner.example.org' | sudo tee -a /etc/sane.d/net.conf
scanimage -L

Das net-Backend (in dll.conf eingetragen) fragt alle Hosts aus net.conf bzw. SANE_NET_HOSTS. Entfernte Geräte heißen dann net:<host>:<backend>:<gerät>.

device `net:scanner.example.org:test:0' is a Noname frontend-tester virtual device

sudo systemctl stop saned.socket
sudo saned -l -e -d 5 -o

-l eigener Lauschmodus (ohne inetd/systemd), -e Debug auf stderr statt syslog, -d 5 Debug-Stufe, -o nach dem ersten Client beenden. Nicht dauerhaft als root laufen lassen (-u saned).

# /etc/sane.d/saned.conf
data_portrange = 10000 - 10100

sudo nft add rule inet filter input tcp dport { 6566, 10000-10100 } ip saddr 192.0.2.0/24 accept

Die Steuerung läuft über 6566/tcp, die Bilddaten über einen zweiten, dynamisch gewählten Port (Antwort auf SANE_NET_START). Hinter einer Firewall den Bereich festlegen – oder unter Linux das Modul nf_conntrack_sane nutzen.

airscan-discover

Werkzeug aus sane-airscan: sucht per mDNS (_uscan._tcp) und WS-Discovery und gibt fertige Zeilen für /etc/sane.d/airscan.conf aus.

[devices]
  "Beispiel MFP 400" = http://192.0.2.40:80/eSCL/, eSCL
  "Beispiel MFP 400" = http://192.0.2.40:5358/WSDScanner, WSD

avahi-browse -rt _uscan._tcp

Zeigt eSCL-Scanner mit TXT-Einträgen (rs, cs, is, pdl …). _uscans._tcp ist die TLS-Variante.

sudo usermod -aG scanner "$USER"
# danach ab- und wieder anmelden
id -nG

Unter Debian/Ubuntu geben die udev-Regeln von libsane der Gruppe scanner Zugriff auf die USB-Geräte. Funktioniert scanimage -L nur mit sudo, fehlt fast immer diese Berechtigung.

benutzer adm cdrom sudo plugdev scanner

lsusb | grep -i 1234:5678
sudo fuser -v /dev/bus/usb/001/007

Liefert sane_open() SANE_STATUS_DEVICE_BUSY, hat oft ein anderes Frontend (oder ein hängender saned) das Gerät offen.

SANE_DEBUG_DLL=255 scanimage -L 2>&1 | head -20

Das dll-Meta-Backend protokolliert, welche Einträge es aus dll.conf und dll.d/ liest und welche Bibliotheken es per dlopen() lädt. Stufe 255 = alles.

[sanei_debug] Setting debug level of dll to 255.
[dll] sane_init: SANE dll backend version … from sane-backends …
[dll] add_backend: adding backend `test'
[dll] load: searching backend `test' in `/usr/lib/x86_64-linux-gnu/sane'
[dll] load: trying to load `/usr/lib/x86_64-linux-gnu/sane/libsane-test.so.1'
[dll] init: initializing backend `test'
(gekürzt)

SANE_DEBUG_NET=128 SANE_DEBUG_SANEI_USB=5 scanimage -L

Jedes Backend hat eine eigene Variable SANE_DEBUG_<BACKEND> (Großbuchstaben): SANE_DEBUG_PIXMA, SANE_DEBUG_GENESYS, SANE_DEBUG_ESCL … SANE_DEBUG_SANEI_USB zeigt den USB-Verkehr.

SANE_CONFIG_DIR=$HOME/sane-test: scanimage -L

Sucht Konfigurationsdateien erst im angegebenen Verzeichnis. Endet der Wert mit :, werden danach auch die Standardverzeichnisse durchsucht.

tesseract scan.png ergebnis -l deu
tesseract scan.png ergebnis -l deu pdf

Erzeugt ergebnis.txt bzw. ein durchsuchbares ergebnis.pdf. Für OCR sind 300 dpi Graustufen ein guter Ausgangswert; Lineart verliert bei kleiner Schrift Details.

img2pdf seite*.png -o scan.pdf
ocrmypdf -l deu --deskew --rotate-pages scan.pdf scan-ocr.pdf

img2pdf bettet die Bilder verlustfrei ein, ocrmypdf legt eine unsichtbare Textebene darüber (Tesseract), richtet schiefe Seiten gerade und dreht auf dem Kopf liegende Seiten.