# SANE - Contributing or: How Can You Help SANE?

We appreciate any help we can get. Here are some topics on which you can work:

## Information for Manufacturers

Are you a manufacturer or vendor of scanners and one of your scanners is not supported by SANE yet? In this case please have a look at our information for manufacturers.

## Reporting Unsupported Scanners and Adding more information

If you can provide more information for one of the scanners that's listed as "unsupported" in our current list of unsupported scanners or even want to add a new scanner, please send all information you have to us. If you own an unsupported scanner, please send as much information as possible. Especially the output of sane-find-scanner -v -v and/or cat /proc/scsi/scsi (for SCSI scanners) or cat /proc/bus/usb/devices (for USB scanners) can help. If you dare to open the scanner, have a look at the text that's printed on the chips. That may help to identify the chipset. If you know that the scanner is similar to another one (e.g. supported by the same Windows driver), please also mention this fact. Contact us by using using the form for adding an unsupported device or by sending mail to the sane-devel mailing list. If you think anything in the list or on this web page is wrong, please also contact us or file a bug report.

## Writing a Backend (Driver)

If your scanner is unsupported by SANE, please consider writing a backend for it. As scanners are very different to each other, you can't expect the SANE developers to write the backend for you. If your scanner is similar to one that already works, it may be easy to add support. But if it's necessary to write a completely new backend, it's up to you.

The time and skills needed for writing a backend depends on the "intelligence" of the scanner. If it's rather high-level, i.e. understand commands like "scan-at-600-dpi", it may be possible to write a basic driver in 10-20 hours. If the protocol is more low-level (e.g. move-motor-one-step), it can take much longer.

You don't need to be an experienced programmer. Backends are usually written in C, so some basic knowledge of this language helps. You need a lot of patience, however, especially if you can't get programmer's documentation from your scanner's manufacturer.

If you intend to write a backend: contact the sane-devel mailing list and let us know. Get all the information about your scanner that's available: chipset application manual (sometimes it's on the web), Windows drivers used (sometimes they tell which chipset is used), programmer's information (if the manufacturer provides those). If you don't have enough information about the protocol used by the scanner, try to find out what the MS Windows driver does. For basic information about how SANE works, get the latest development version of SANE, read man sane and doc/backend-writing.txt. Also have a look at existing backends, e.g. one of the USB backends, if you want to support a USB scanner.

## Writing a Frontend

There are already some very capable frontends. So helping with improving the existing frontends may make more sense than to write yet another one. On the other hand there may be reasons to start writing a completely new frontend, like support for a specific widget set, a programming language or a special type of devices (e.g. cameras, slide scanners). In any case, keep the sane-devel mailing list informed of your plans.

## Reporting Bugs and Missing Features

If you think something in SANE isn't working as it should, please don't hesitate to file a bug report Please provide as many details as possible. Describe which software you are using (operating system + version, distribution, version of sane-backends and of the frontend you use). Explain exactly what doesn't work, is wrong or missing.

## Adding and fixing documentation

If you found a bug in any documentation (man pages, web site, READMEs), please contact us using the sane-devel mailing list or file a bug report. Also write us if you think some documentation is missing. Please include a patch in this case, if possible. Don't hesitate to send spelling and grammar mistakes. Most of us are not native English speakers.

## Translations

The options of the backends can be translated. For some languages, the translations are almost complete, but some are lacking a lot of words and for most languages there is no translation at all. If you want to help to translate the options to your native language (or a language you speak fluently), contact the sane-devel mailing list and have a look at the po/ directory in the source code.

## Success reports

If you had success using SANE we want to know about that, too. Especially if your scanner is not in the lists yet or is marked "untested". Please send an email to the sane-devel mailing list or file a bug report.

SANE homepage
Contact

$Date$ $Author$