Xsane For Mac

 



Mac

This is a TWAIN datasource for MacOS X that aquires images using theSANE backend libraries. The SANE backend libraries provide access to alarge range of scanners connected through SCSI or USB. For a completelist see the documentation on the SANE project homepage. Itworks with my HP SCSI scanner, and many people have reported successwith a large number of different scanners. The feedback from usershave helped the SANE developers to fix problems with various backends,so with each release of the SANE backends more of the MacOS X specificproblems have been solved.

XSane is an open source and freely distributed graphical application implemented in GTK+ and designed from the offset to act as a GUI (Graphical User Interface) for the SANE (Scanner Access Now Easy) image scanning command-line program. YAGF is a graphical front-end for cuneiform and tesseract OCR tools. With YAGF you can open already scanned image files or obtain new images via XSane (scanning results are automatically passed to YAGF). Once you have a scanned image you can prepare it for recognition, select particular image areas for recognition, set the recognition language and so on. XSane (temporarily offline!) - improved graphical frontend for scanners: NEW: with color management support (ICC/ICM profiles) improved enhancement functions (gamma handling) histogram stand-alone mode: scan and save utility (file formats: jpeg, png, pnm, ps, raw, tiff) scan and view copy utility fax utility. How to configure your SCSI or USB scanner to work with SANE/XSANE from your regular user account. Version 1.0 Author: VirtualEntity When I try to run XSANE, the program reports 'No devices found' and doesn't see my scanner. When I run sane-find-scanner, the same thing happens and the program reports.

The TWAIN SANE interface is not a standalone application. It isdesigned to be used from within other applications. It works withapplications supporting the TWAIN specification, which includes mostapplications on Mac OS X that handles images. However using it withApple‘s Image Capture application has become increasingly tricky withevery version of Mac OS X. You will have an easier experience if youchoose any other application.

The TWAIN SANE Interface is provided as a binary package and as sourcecode. To use the interface you only have to install the binarypackage. Before installing the TWAIN SANE Interface package you shouldinstall the libusb and the sane-backends binary packages.

There is also a optional SANE Preference Pane package available, whichmakes it easier to configure the sane-backends drivers. If you don’tinstall this package you can still configure the sane-backends using atext editor in the Terminal.

If you have trouble making it work, please consult the list of frequently asked questions.

If you want to compile the sources you also have to install thegettext package. If you are cross-compiling using the MacOS Xcross-compilation SDKs you need to install the corresponding SDKs forthe used packages.

You are welcome to contact me at mattias.ellert@physics.uu.seif you want to have more information about the TWAIN SANE Interface,or if you want to submit bug reports, localizations errors,suggestions for improvments or patches.

The latest version is 3.6.

Mattias Ellert

Downloads

VersionInstallerSourcesProject Homepage
TWAIN SANE Interface3.6http://www.ellert.se/twain-sane/
SANE Preference Pane1.6http://www.ellert.se/twain-sane/
SANE backends1.0.25http://www.sane-project.org/
libusb0.1.13 betahttp://www.libusb.org/
gettext0.19.8.1http://www.gnu.org/software/gettext/

Older versions.

Release Notes

TWAIN SANE Interface version 3.6, 2017-05-26

  • Compiled for macOS 10.9 or later.

SANE Preference Pane version 1.6, 2017-05-27

  • Compiled for macOS 10.6 or later

sane-backends version 1.0.25, 2017-05-22

  • Compiled for macOS 10.9 or later
  • Stop building SDK packages

libusb version 0.1.13 beta, 2016-11-02

  • Compiled for macOS 10.9 or later
  • Stop building SDK packages

gettext version 0.19.8.1, 2017-05-21

  • Compiled for macOS 10.7 or later
  • Stop building SDK packages

Localizations

The TWAIN SANE Interface has been localized to the followinglanguages: English, French, German, Italian, Japanese, Russian andSwedish. For most of the translation it relies on the localizationsupport in the SANE backend libraries.

Xsane for mac download

If you want to provide localization support for a different language you arewelcome to do that. What you should do is the following:

  • You might want to check with me that I did not already recieve thelocalization for your language from someone else...
  • First check if there exists a file called/usr/local/share/locale/〈langcode〉/LC_MESSAGES/sane-backends.mocontaining the localizations for the SANE backend libraries for your language.If there is no such file you must first localize the SANE backend libraries.For more information about this see theSANE project homepage.
  • Download the TWAIN SANE Interface source code.
  • After unpacking the source tarball you will find in it a directory called src.In this directory there is one language project directory for each language(English.lproj, Swedish.lproj, etc.). In these directories there are two filescalled InfoPlist.strings and Localizable.strings.
  • You should create your own copy of these two files and change the translations.These files contain several lines of the type 'key' = 'value'. Do not changethe keys, but translate the values. Note that these files should be in theUTF-8 encoding.
  • There is also a set of language project files in the pkg/Resourcesdirectory. These contain localization files for the Installer called.If you want you can also provide localized versions of these. Thesefiles are also of the 'key' = 'value' type and should also be in theUTF-8 encoding.
  • Send the files to me, and I will include them in my next release.

Mattias Ellert


Contents

  1. How to share scanners using SANE daemon (saned)
  2. Setup saned clients
  3. Troubleshooting sane daemon with upstart
  • This tutorial will guide you on how to setup and access a scanner shared over a network. This allows other devices to access the scanner, without having to have the scanner plugged directly into the computer.

A number of assumptions were made regarding this tutorial, that may need to be changed to fit your environment:

  • The network is 192.168.0.0/24.
  • The scanner works locally.
  • The scanner server (the machine the scanner is local to) is located at 192.168.0.15.
  • The scanner server is running Ubuntu.
  • The following step-by-step guide to setting up saned should work for the vast majority of scanners. If you need to add scanner specific information, please do so on the scanner's wiki page.
Xsane macintosh

Step 1: Set up your scanner on SANE first

  • In order to make network scanning work, you first need to get SANE working with your scanner. If your scanner is a USB scanner do not proceed to step 2 until it is correctly scanning via USB. If your scanner is a network attached scanner, you need to get it working on your saned server before sharing it out on the network. See the Scanners page for help setting up and troubleshooting sane.

Step 2: Tell SANE to run as a server (saned)

systemd only

  • Execute at a terminal:

    and input exactly:

    Execute at a terminal:

    and input exactly:

upstart only

  1. We need to edit the file /etc/default/saned to tell the computer to start the saned server. To do that, we will run the following command from a terminal:

  2. Look for the section that reads:

  3. Edit that so that it reads:

  4. Save, and close.

Step 3: Tell saned who to share with

  1. We need to edit the file /etc/sane.d/saned.conf to tell saned who to share with. To do that, we will run the following command from a terminal:

  2. Look for the section that reads:

  3. Assuming you don't need to control access to the scanner, we will add the line '192.168.0.0/24' (share with everyone on the local network) after '## Access list':

  4. Save the file and close.

Step 4: Clean up tasks

systemd only

  • Execute at a terminal:

    This should result in something similar to:

upstart only

  1. Restart the saned service to get the new configurations by running the following command in a terminal:

  2. For Ubuntu 12.04 only, you will need to tell the computer to start saned automatically when the computer boots up by running the following command in a terminal:

  3. Check to make sure the saned service is up and running:

    It should return something along the lines of: If it does not, see the section on troubleshooting.

  • Now that you have your server set up, its time to setup your clients.

Setup Linux clients

  1. We need to tell the client computer where to find the saned server we want to connect with. To do that, we have to edit the file /etc/sane.d/net.conf by running the following command:

  2. Find the line that reads:

  3. After that line, you need to add a line with the address of the Ubuntu system we installed the server on. That line will look like this:

  4. Find the line that reads:

    and change it so that it reads:

  5. Save the file and close.

  6. Open Simple Scan. It will take a few seconds for the auto-discovery to work, and then the scanner will populate in the menu. Alternatively, one may use XSane Image scanning program, either via the GUI menu, or from a terminal: and you should see you scanner.

Xsane for mac

Setup Windows clients

Xsane Mac Os Download

  • By default, Windows cannot connect to a saned network scanner (ex. Windows 7, or Windows 8.1 using the built-in Scan app). This is because sane servers do not use the Microsoft Scan Service (WS-Scan) protocol, and vice-versa. However, several tools are available to allow Windows machines to use sane servers for scanner access. For example, in Windows one may download an installer via http://sanetwain.ozuzo.net/ (1.36 tested working in Windows 8.1 x64).

Setup Mac client

  • Twain-SANE is a bridge for the MAC platform (10.6, 10.7) that allows you to use a SANE shared scanner with any twain enabled Mac program. For more on this project, see http://www.ellert.se/twain-sane/. If you really need to, SANE front ends are available for these platforms.

  • If your network scanner does not work, the following procedures may be of help. Try to follow these steps in order.

Make sure your scanner works locally

  • From the server that is sharing out the scanner, make sure you can scan. If it doesn't work locally, it won't work remotely.

Make sure the saned service is running

  • From the server sharing out saned, run the following command: it should show the saned service as up and running.

Test if the server can reach its own saned on localhost

  • Instead of using the scanner directly, try and access it via the localhost interface. If this doesn't work, it won't work across the network. Due to a bug in udev, it may be necessary to add the saned user to the lp group with this command: and restart the saned service.

Export the scanner to localhost

  1. Edit the saned.conf file by running the following command:

  2. Look for the section that reads:

    and add the following lines: Save the file and close.

Tell SANE to use localhost

Xsane For Mac

  • From the command line, run the following command to open net.conf in gedit:

    Look for the section that reads:

    We need to add a line to tell SANE to use localhost for a host:

Test XSane

  • From the command line, run: You should now see two copies of your scanner. Make sure both can actually scan.

Check using XSane and command line options

  • From the command line, run the command:

    Assuming that your scanner uses the epson2 backend, the command would be:

Check the local connection with telnet

  • If the above procedure doesn't work, you need to make sure you can connect to the saned server with telnet. We also should log what happens. We can do that by running the following commands:

Manually check other configuration files (advanced)

  • There are a number of configuration files that may cause a problem. Please attempt all other solutions before going down this path (including asking for help).

Xsane Mac Os

/etc/services

  • For all backends, check to make sure the following service is present:

    For those backends that require it, check to make sure the following service is present:

Xsane For Mac Download

/etc/hosts.allow & /etc/hosts.deny

  • Try temporarily commenting out any entries in these files. If you can scan after doing this, then you will need to specifically add your host or hosts to the /etc/hosts.allow file. The following entry will give access to saned to the local network:

Compiling Sane from GIT

  • If Sane has a bug, please first file a bug report following the instructions here. While waiting for a fix, one may compile sane from GIT.

  • If these steps have failed, you are welcome to contact the sane-devel@lists.alioth.debian.org mailing list for additional support.