initial commit

2026-07-12 10:17:17 -04:00
commit dab5a4ebc6
1424 changed files with 330463 additions and 0 deletions
@@ -0,0 +1,93 @@
+# Brother MFC → Paperless-ngx Scan Pipeline
+
+Network scanner → Paperless consume folder, no drivers, no printer web admin password required.
+
+## Prerequisites
+
+- Brother MFC with network (WiFi or Ethernet) on same LAN as server
+- `sane-airscan` installed (`sudo apt install sane-airscan sane-utils`)
+- Paperless-ngx running with a consume folder mounted
+
+## Setup (once)
+
+### 1. Verify scanner discovery
+
+```bash
+scanimage -L
+# Should show:
+# device `airscan:e0:Brother MFC-J5855DW' is a eSCL Brother MFC-J5855DW ip=192.168.50.219
+```
+
+No Brother drivers needed — `sane-airscan` uses the driverless eSCL/AirScan protocol.
+
+### 2. Ensure write access to consume folder
+
+```bash
+sudo setfacl -m u:$USER:rwx /path/to/paperless/consume
+```
+
+### 3. Install scan script at `/usr/local/bin/scan-to-paperless`
+
+```bash
+#!/bin/bash
+# scan-to-paperless — scan from Brother MFC → Paperless consume folder
+# Usage: scan-to-paperless [name] [--flatbed] [--gray] [--150dpi]
+
+set -e
+
+DEVICE="airscan:e0:Brother MFC-J5855DW"
+CONSUME="/mnt/seagate8tb/paperless/consume"
+MODE="Color"
+RES="300"
+SOURCE="ADF"
+
+NAME=""
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --flatbed) SOURCE="Flatbed" ;;
+        --gray)    MODE="Gray" ;;
+        --150dpi)  RES="150" ;;
+        *)         NAME="${1}_" ;;
+    esac
+    shift
+done
+
+SCAN_OPTS="--mode $MODE --resolution $RES"
+if [ "$SOURCE" = "ADF" ]; then
+    SCAN_OPTS="$SCAN_OPTS --source ADF --batch-count=1"
+fi
+
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+FILENAME="${NAME}scan_${TIMESTAMP}.pdf"
+OUTFILE="$CONSUME/$FILENAME"
+
+echo "📄 Scanning ($SOURCE, $MODE, ${RES}dpi) → $FILENAME"
+scanimage --device "$DEVICE" $SCAN_OPTS --format pdf -o "$OUTFILE"
+
+SIZE=$(du -h "$OUTFILE" | cut -f1)
+echo "✅ Done — $SIZE saved to Paperless"
+```
+
+## Daily usage
+
+```bash
+scan-to-paperless                    # ADF, color 300dpi
+scan-to-paperless invoice            # names it invoice_scan_20260614_172310.pdf
+scan-to-paperless --flatbed          # use flatbed (photos, fragile docs)
+scan-to-paperless --gray --150dpi    # B&W, low res (small file)
+```
+
+## Flow
+
+```
+scan-to-paperless
+  → Brother scans via eSCL (AirScan over HTTP)
+    → PDF saved to /mnt/seagate8tb/paperless/consume/
+      → Paperless auto-ingests, OCRs, classifies, tags
+```
+
+## Alternative approaches that failed
+
+- **Scan-to-FTP via Brother web interface**: Requires printer admin password. Defaults (`initpass`, `access`, `brother`) don't work on modern Brother MFCs (unique per-device password on sticker).
+- **Scan-to-SMB via Brother**: Also requires web admin to create the profile. Samba share was set up but could not be configured on the printer side without the web password.
+- **Brother brscan4 driver**: Proprietary `.deb` behind an EULA wall that requires browser cookie; `sane-airscan` driverless approach is simpler and works immediately.