Brother Solutions Center
Please use your Browser 'Back Button' to go to the previous page.

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.

Installing the tool

Notes

  • 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

 

Using the tool

Notes

  • If you are running an internal firewall, configure it to allow port 54925 through on UDP.
  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. How do I terminate the tool?

    You can terminate brscan-skey by running the following command:

    brscan-skey -t

 

Tips for using the tool

  1. 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.
  1. 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

  2. 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

Notes

  • 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



Legal | Global Site