Added scanbd2smb

Author: mietzen

.gitignore

@@ -0,0 +1 @@
+.DS_Store

scanbd2smb/CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog:
+## Version 0.1.0
+- First release of scandb2smb addon

scanbd2smb/Dockerfile

@@ -0,0 +1,41 @@
+FROM debian:trixie-20250908-slim
+
+RUN apt-get update && \
+    apt-get install -y \
+        sane \
+        scanbd \
+        imagemagick \
+        exactimage \
+        pdftk \
+        tesseract-ocr \
+        tesseract-ocr-eng \
+        libusb-dev \
+        smbclient \
+        jq \
+    && rm -rf /tmp/* /var/{cache,log}/* /var/lib/apt/lists/*
+
+COPY ./scan.sh /scan.sh
+RUN chmod +x /scan.sh
+
+RUN sed -i '/action scan {/,/}/s|script = ".*"|script = "/scan.sh"|' /etc/scanbd/scanbd.conf
+
+COPY ./entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+
+ENTRYPOINT [ "/entrypoint.sh" ]
+
+ARG VERSION
+LABEL \
+    io.hass.name="scanbd2smb" \
+    io.hass.description="Scan from your USB Scanner to a SMB Folder." \
+    io.hass.version="${VERSION}" \
+    io.hass.type="addon" \
+    io.hass.arch="armhf|aarch64|i386|amd64|armv7" \
+    maintainer="Nils Stein <[email protected]>" \
+    org.opencontainers.image.title="scanbd2smb" \
+    org.opencontainers.image.description="Scan from your USB Scanner to a SMB Folder." \
+    org.opencontainers.image.vendor="Nils Home Assistant Add-ons" \
+    org.opencontainers.image.authors="Nils Stein <[email protected]>" \
+    org.opencontainers.image.licenses="MIT" \
+    org.opencontainers.image.source="https://github.com/mietzen/hassio-addons" \
+    org.opencontainers.image.documentation="https://github.com/mietzen/hassio-addons/blob/main/p910nd/README.md"

scanbd2smb/README.md

@@ -0,0 +1,17 @@
+## **Status: Untested Beta ×**
+
+# Home Assistant Add-on: scanbd2smb
+
+Enables you to scan from your USB scanner directly to a SMB share.
+
+## About
+
+This add-on uses **scanbd** to listen for scanner button presses and automatically scans documents.
+Scans are processed with **OCR (Tesseract)** and stored as compressed searchable PDFs on your SMB share.
+
+## Installation
+
+1. Navigate in your Home Assistant frontend to **Settings** -> **Add-ons** -> **Add-on Store** and add this URL as an additional repository: `https://github.com/mietzen/hassio-addons`
+2. Refresh your browser.
+3. Find the "scanbd2smb" add-on and click the "INSTALL" button.
+4. Configure the add-on and click on "START".

scanbd2smb/config.yaml

@@ -0,0 +1,37 @@
+name: scanbd2smb
+version: 0.1.0
+slug: scanbd2smb
+description: Enables you to scan from your USB Scanner to a SMB Folder.
+url: https://github.com/mietzen/hassio-addons/tree/master/scanbd
+arch:
+  - armhf
+  - armv7
+  - aarch64
+  - amd64
+  - i386
+startup: application
+boot: auto
+homeassistant_api: false
+hassio_api: false
+hassio_role: manager
+stdin: true
+image: mietzen/hass-addon-scanbd2smb
+init: false
+usb: true
+
+options:
+  smb_share: ""
+  smb_user: ""
+  smb_password: ""
+  ocr_language: "eng"
+  scan_resolution: 300
+  scan_mode: "Color"
+
+schema:
+  smb_share: str
+  smb_user: str
+  smb_password: str
+  ocr_language: str
+  scan_resolution: int
+  scan_mode: str
+  log_level: list(debug|info|warning|error)?

scanbd2smb/entrypoint.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -e
+
+# Read options.json into env vars
+export SMB_SHARE=$(jq -r '.smb_share' /data/options.json)
+export SMB_USER=$(jq -r '.smb_user' /data/options.json)
+export SMB_PASSWORD=$(jq -r '.smb_password' /data/options.json)
+export OCR_LANGUAGE=$(jq -r '.ocr_language' /data/options.json)
+export SCAN_RESOLUTION=$(jq -r '.scan_resolution' /data/options.json)
+export SCAN_MODE=$(jq -r '.scan_mode' /data/options.json)
+
+if ! dpkg -l | grep -q "tesseract-ocr-${OCR_LANGUAGE}"; then
+    echo "OCR Language: $OCR_LANGUAGE not installed! Installing:"
+    apt-get update
+    apt-get install --yes "tesseract-ocr-${OCR_LANGUAGE}"
+fi
+
+echo "ScanBD starting with:"
+echo "  SMB_SHARE=$SMB_SHARE"
+echo "  SMB_USER=$SMB_USER"
+echo "  OCR_LANGUAGE=$OCR_LANGUAGE"
+echo "  SCAN_RESOLUTION=$SCAN_RESOLUTION"
+echo "  SCAN_MODE=$SCAN_MODE"
+
+exec /usr/sbin/scanbd -f

scanbd2smb/icon.png

@@ -0,0 +1,44 @@
+#!/bin/bash
+set -euo pipefail
+
+TMP_DIR=$(mktemp -d)
+FILE_NAME="scan_$(date +%Y-%m-%d-%H%M%S)"
+
+echo 'Scanning...'
+scanimage --resolution "$SCAN_RESOLUTION" \
+          --batch="$TMP_DIR/scan_%03d.pnm" \
+          --format=pnm \
+          --mode "$SCAN_MODE" \
+          --source "ADF Front"
+
+echo "Output saved in $TMP_DIR/scan*.pnm"
+cd "$TMP_DIR"
+
+# Convert to TIFF
+for i in scan_*.pnm; do
+    echo "Converting $i"
+    convert "$i" "$i.tif"
+done
+
+# OCR
+echo 'Performing OCR...'
+for i in scan_*.tif; do
+    echo "Processing $i"
+    tesseract "$i" "$i" -l "$OCR_LANGUAGE" hocr
+    hocr2pdf -i "$i" -s -o "$i.pdf" < "$i.hocr"
+done
+
+# Merge PDFs
+echo 'Merging PDFs...'
+pdftk *.tif.pdf cat output compiled.pdf
+
+# Compress final PDF
+gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.4 -dPDFSETTINGS=/ebook \
+   -dNOPAUSE -dQUIET -dBATCH \
+   -sOutputFile="$FILE_NAME.pdf" compiled.pdf
+
+# Upload via Samba
+smbclient "$SMB_SHARE" -U "$SMB_USER"%"$SMB_PASSWORD" -c "put $FILE_NAME.pdf"
+
+# Cleanup
+rm -rf "$TMP_DIR"

scanbd2smb/scan.sh

@@ -0,0 +1,7 @@
+title "scandb2smb Integration Test"
+
+describe processes(Regexp.new("scandb")) do
+  it { should exist }
+  its('users') { should include 'root' }
+  its('pids') { should cmp "1"}
+end

scanbd2smb/test/integration/controls/scandb2smb.rb

@@ -0,0 +1,3 @@
+---
+lockfile_version: 1
+depends: []