Installing /Using the Brother Scan key tool into a Linux based system
using SANE (for USB/Network Users)
Please be sure to install the latest
Scanner driver ver.0.2.4 or later before installing the Scan key
tool.

- This tool requires the "scanimage" and "GIMP". "
scanimage" may be included in sane-backends package.
- For Ubuntu/Kubuntu Users:
This tool requires the "sane-utils" module.
For Debian/Ubuntu Users, type the following from a terminal:
dpkg -i brscan-skey-0.2.1-1.i386.deb
dpkg -i brscan-skey-0.2.1-1.amd64.deb
For Other Users, type the following from a terminal:
rpm -ihv brscan-skey-0.2.1-1.i386.rpm
rpm -ihv brscan-skey-0.2.1-1.x86_64.rpm

- If you are running an internal firewall, configure
it to allow port 54925 through on UDP.
- How to run the tool:
You can run the tool both manually and automatically.
| Running the tool manually |
Open a TERMINAL, type "brscan-skey", and press Enter.
This program will return to the command prompt immediately but will stay
working in the background. Your PC is now registered to the Brother machine
as the Scan-key target PC.
"
Scan to Image", "Scan to File" and "Scan to E-mail" functions
will be activated.
| Running the tool automatically |
For GNOME Users (Below is an example of Ubuntu 6.10):
(1) Open the "System" menu and select "Preference".
(2) Select the "Sessions" item in the "Preference" sub
menu.
(3) Select the the "Startup" tab.
(4) Click the the "Add" button.
(5) type "brscan-skey" in the "Startup command" window.
(6) Click the "OK" button.
For KDE Users:
Start brscan-skey, end your session and they should start up automatically
(By default)
For Other Users:
Please refer to the User's Guide of your Desktop system.
- Where is the scanned data stored?
When you use the "Scan to File" functions
of Scan-key, the scanned file is stored in the "brscan" directory
on the users home directory (~/brscan) .
When you use the "Scan to Image" function
of Scan-key, the scanned file is opened by GIMP.
- How do I change the PC name?
When you first configure the application, your login name is registered
to the Brother machine as the Scan-Key target PC name. To change
it, run the following command:
brscan-skey -u xxxxxx
Where "
xxxxxx" is the new user name. The new user name must be less than 16 characters,
and consist of alphanumeric characters.
If you use this "-u" option without any parameters, you can restore
it
to the original name (login user name).
This new user name will not be effective until brscan-skey runs again.
- How do I change the password?
When you first configure the feature, a password
is not registered. You can change the password by running the following
command:
brscan-skey -p xxxx
Where "
xxxx" is the 4 digit number. This new password will not be effective
until the tool runs again.
- How do I terminate the tool?
You can terminate brscan-skey by running the following command:
brscan-skey -t
- How do I search for available Brother machines?
To search for Brother machines, you can use the following
command:
brscan-skey -l
This command shows the list of the available Brother machine in the following
format:
For USB Users:
Friendly name ; sane device name ; USB ; status
*Friendly name is a machine name, which is one for every USB connected machines.
Below is an example:
| MFC-7820N ; brother2;bus4;dev1 : USB Active |
For Network Users:
Friendly name ; sane device name ; IP address or node name ; status
Below
is an example:
Brother machine-780 ; brother2;net1;dev1 : 10.136.100.2 Not
registered
Brother machine-886 ; brother2;net1;dev2 : BRN_487DBD Not
responded |
- Active : This Brother machine is active.
- Not responded : This Brother machine
is not responding (Maybe power off)
- Not registered : This Brother machine
is not registered as a Scan-key Brother machine.
If your network connected Brother machine is not listed , we recommend
you check whether the Brother machine is already registered to sane
by running the brsaneconfig /brsaneconfig2 command.
- How do I register the PC to a specific
Brother machine?
Usually, brscan-skey registers your PC to all connected Brother
machines. If you would like to register to only one Brother machine,
you
can use the following command:
For USB Users:
brscan-skey -a \\USB
If you are connecting more than two USB devices, you cannot specify only
one. All connected USB machines will be registered.
For Network Users:
brscan-skey -a XXXX
Where XXXX is a friendly name of the Brother machine you want to register
to.
If you don't know the friendly name of the Brother machine, please confirm
it by running the following command:
brscan-skey -l
- How do I exclude specific Brother machines?
If you don't want to register a specific
Brother machine, use the following command:
For USB Users:
brscan-skey -d \\USB
If you are connecting more than two USB devices, you cannot specify
only one. All connected USB machines will be excluded.
For Network Users:
brscan-skey -d XXXX
Where XXXX is a friendly name of the Brother machine you want to exclude
.
If you don't know the friendly name of the Brother machine, please confirm
it by running the following command:
brscan-skey -l
| Tips for "Scan
to E-mail" function Users |

- To use the "Scan to E-mail" function, you need to install "sendmail"
or "postfix".
Check there is the file "/usr/sbin/sendmail" on
your PC.
The configuration file "brscan_mail.config" for
the "Scan to E-mail" function
is located in the following directories.
/usr/local/Brother/sane/
or, for a individual setting:
~/brscan/
You can also set an address by using "-m" option:
brscan-skey -m xxxxxxx@yyy.zz
The preference order of these three patterns
is:
"-m" option > ~/brscan/brscan_mail.config > /usr/local/Brother/sane/brscan_mail.config
The following is the default setting of the configuration
file.
Please change the contents according to your requirement.
FROM=
TO=
MESSAGE=/usr/local/Brother/brscan_mailmessage.txt
SUBJECT=Scan to E-MAIL |
- FROM= Sender's
address
- TO= Address
- MESSAGE= Message
body (text file) *You need to specify a file with a full path.
- SUBJECT= Message
subject
You can also include the following settings in the file:
- CC= Address to cc
- BCC= Address to bcc
| Information for developers |
The configuration file "brscan-skey-net-0.2.0-1.cfg" for
the Scan-key tool is located in the following directory:
/usr/local/Brother/sane/
And you can change the process by modifying this file.
password=
IMAGE="sh /usr/local/Brother/sane/script/scantoimage-0.2.0-1.sh"
OCR=
EMAIL=
FILE="sh /usr/local/Brother/sane/script/scantofile-0.2.0-1.sh" |
- IMAGE= For "Scan to Image" function
- OCR= For "Scan to OCR" function
- EMAIL= For "Scan to Email" function
- FILE= For "Scan to File" function
For
detail please refer the following file:
/usr/local/Brother/sane/script/scantofile-0.2.0-1.sh
For example if you want to save a scanned data
in PDF format, it's possible by editing this file.
Change
the line:
scanimage
--device-name "$device" --resolution
$resolution > "$output_file".pdf
to:
scanimage --device-name "$device" --resolution
$resolution \
| pnmtops | gs -q -dNOPAUSE -sDEVICE=pdfwrite \
-sOutputFile=- - > "$output_file".pdf
|