Skip to content

Python programmed tool as alternative to the brscan-skey tool.

License

Notifications You must be signed in to change notification settings

crazyduck/brother-scan

 
 

Repository files navigation

brother-scan

This tool is alternative to the brscan-skey with automatic document feeder support and compressed PDF output.

Using Docker

The easiest way to use brscand is to build a Docker image with the Dockerfile provided here.

Requirements

Build image

Make sure you have downloaded the brscan4 deb file and placed it in the top-level directory of the repository next to the Dockerfile.

Adapt BRSCAN_DEB if the version has changed.

python3 setup.py build sdist
docker build -t brscan --build-arg BRSCAN_DEB="brscan4-0.4.10-1.amd64.deb" .

Configuration

Edit brother-scan.yaml according to your preferences.

Run

To run brscand with the following setup:

  • DCP-7065DN scanner.
  • Scanner at IP address 192.168.10.20.
  • Host OS at IP address 192.168.10.10.
  • OCR output written to $HOME/brscan/consume
  • All other output written to $HOME/brscan/output
docker run -d \
  -v $HOME/brscan/output:/output \
  -v $HOME/brscan/consume:/consume \
  -v $(pwd)/brother-scan.yaml:/brother-scan.yaml \
  -e SCANNER_NAME=Brodrucker \
  -e SCANNER_MODEL=DCP-7065DN \
  -e SCANNER_IP=192.168.10.20 \
  -e ADVERTISE_IP=192.168.10.10 \
  -p 54925:54925/udp \
  --name BrotherScanKey \
  brscan

Running on host OS

If you for some reason want to run it directly on your Linux host OS, that might also be possible. It probably need to be Ubuntu, Debian, RedHat or something like that to make it work.

Python Virtual Environment

It is recommanded to use venv (Python Virtual Environment) to install the required Python modules.

Requirements

In order for this to work, host OS must have the following installed (assuming Debian)

  • sane and sane-utils packages (scanimage and scanadf commands)
  • poppler-utils package (pdfunite command)
  • libusb-0.1-4 package (libusb-0.1.so.4 library)
  • brscan4 (brscan4-0.4.4-1.amd64.deb can be fetched from Brother)

Installation

python3 -m venv .
./bin/pip install -r requirements.txt
python3 setup.py install

Configuration

Run brsaneconfig4 to configure the scanner. Example configuring MFC-L2700DW scanner with IP address 192.168.0.100:

brsaneconfig4 -a name="Brother" model="MFC-L2700DW" ip="192.168.0.100"

Edit brother-scan.yaml according to your preferences.

Run

Now you just need to run the brscand daemon. Example running on host with IP 192.168.0.10 and scanner with IP address 192.168.0.100:

brscand 192.168.0.100 192.168.0.10

Uselinks

Tested devices

  • MFC-L2710DN

About

Python programmed tool as alternative to the brscan-skey tool.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 85.3%
  • Dockerfile 7.8%
  • Shell 6.9%