diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 196 |
1 files changed, 196 insertions, 0 deletions
@@ -0,0 +1,196 @@ + + Image Scan! for Linux + ===================== + +Copyright (C) 2019 SEIKO EPSON Corporation + + + ABSTRACT + -------- + Image Scan! is a graphical scanner utility for people that do not + need all the bells and whistles provided by several of the other + utilities out there (xsane, QuiteInsane, Kooka). + At the moment it only supports SEIKO EPSON devices. However, the + device driver it provides can be used by any other SANE standard + compliant scanner utility. + Note that several scanners require a non-free plugin before they + can be used with this software. Using a scanner directly through + a network interface also requires a non-free plugin. + + LICENSING + --------- + This software is primarily covered by the terms of the GNU General + Public License (version 2 or later) with exceptions that allow for + the use of several non-free plugins. + The graphical user interface, iscan, carries an exception to allow + linking with the non-free 'esmod' library. Copies of that library + are included in the 'non-free/' directory and covered by the terms + of the EPSON END USER SOFTWARE LICENSE. + The device driver (backend) carries a similar exception to provide + for the use of plugins. Such plugins are packaged and distributed + independently from this software and are only required for certain + models and/or hardware options. + + A verbatim copy of the GNU General Public License can be found in + the file 'COPYING'. A verbatim copy of the EPSON End User Software + License can be found in the file 'non-free/COPYING.EPSON.en.txt'. + + +NEWS +==== + + For the latest user visible changes, please refer to the 'NEWS' file. + + +INSTALLATION +============ + + REQUIREMENTS + ------------ + The device information files provided by iscan-data must be installed + prior to the installion of Image Scan! for Linux. These files are + necessary for Image Scan! for Linux to function properly and may be + downloaded via: + + http://download.ebz.epson.net/dsc/search/01/search/?OSC=LX + + BINARY PACKAGES + --------------- + For help on installation of Debian and RPM binary packages refer to + your distribution's documentation. In most graphical environments + just double clicking does the right thing. If that does not work + for you, you can always install from a command line with the least + common denominator tools as follows: + + For Debian packages: + + # dpkg --install iscan_$version-$release_$architecture.deb + + For RPM packages: + + # rpm --upgrade iscan-$version-$release.$architecture.rpm + + Both commands require root user privileges and assume that package + dependencies have been taken care of already. + + BUILDING/INSTALLING FROM SOURCE + ------------------------------- + Generic installation notes can be found in the 'INSTALL' file. See + the `./configure --help` output for details on additional options. + + When using the `--prefix` option with configure, make sure you do + the same when configuring `iscan-data`, otherwise the device + information files necessary for the proper functioning of the + software will not be found. + + After you have installed the software, you may need to arrange for + your device to be recognised automatically by the operating system + and give read/write permissions to the appropriate users. Details + on how to do this may be found in the SANE documentation: + + http://sane.alioth.debian.org/docs.html + + The binary packages take care of this during their installation as + much as possible. + + Users of Debian or RPM based Linux distributions can easily build + their own binary packages (if no binaries are available for their + distribution already). For Debian based distributions, all you + have to do is: + + $ tar xzf iscan_$version-$release.tar.gz + $ cd iscan-$version + $ dpkg-buildpackage -rfakeroot + + Alternatively, you should be able to use any other Debian package + building utility. There are just too many to document ;-) + + For RPM packages, you would just: + + $ rpmbuild -tb iscan_$version-$release.tar.gz + + The above assumes that you have the privileges needed to build RPMs + or configured things to build in a user writable location. + + +NON-FREE PLUGINS +================ + + Non-free plugins that add support for certain models and/or hardware + options can be downloaded via: + + http://download.ebz.epson.net/dsc/search/01/search/?OSC=LX + + Plugins required and/or available for your device are listed on the + download page for the device. Please be sure to download a version + that matches your system. + + +SYSTEM REQUIREMENTS +=================== + + We recommend using one of the major Linux distributions with a Linux + kernel version of 2.6.3 or later (you can check with `uname -r`) as + that is what we normally test with. + + However, the software should still work with kernel versions as far + back as 2.4.8. If you happen to use a pre-2.6.3 kernel version you + may want to take a look at the info in the 'KNOWN-PROBLEMS' file. + + When scanning large originals and/or at large resolutions, the image + files can get pretty big, in the order of tens (or even hundreds) of + megabytes for each scan. You need enough free disk space to store + such large images. Also note that scanning to printer roughly needs + twice the disk space needed for the image in order to succeed. + + The software has been designed so that it does not need to keep the + whole image in memory. As a result, 'iscan' can be used on systems + with relatively little memory. + + +OPERATION +========= + + The software can always be started with the 'iscan' command from the + command line or your desktop's "command runner" utility. + You may also find it in your desktop menu in the "Graphics" section. + + PRINTING + -------- + Scanning "directly" to a printer, by default, sends the image data + to your system's default printer using the 'lpr' command. You can + modify the command used to print via the "Configuration" button. + + GIMP PLUG-IN + ------------ + The software can also be used as a GIMP plug-in to acquire images + directly from the GIMP. After installation of a binary package, + the plug-in is (normally) automatically registered and available + from the "File" -> "Acquire" or the "File" -> "Create" menu. + The exact menu entries may depend on your language settings and + GIMP version. + + OTHER SANE FRONTENDS + -------------------- + If you prefer using another SANE frontend, you can use the device + driver included with this software by selecting a device with the + "epkowa:" substring in its device name. + + NETWORK SCANNING + ---------------- + Scanning directly via a device's network interface is supported + with the help of the non-free 'iscan-network-nt' package. Once this + package has been installed you need to tell the 'epkowa' backend + what network devices it should try to access. The details of how + you do this can be found in the 'epkowa.conf' file. + This file is included in the sources and typically installed as + '/etc/sane.d/epkowa.conf'. + + Notes: + 1. 'iscan' does not support setting the IP address of the device + itself. Please consult the device manual for instructions on + how to do this. + 2. The download site only lists the iscan-network-nt module for the + devices that are known to work with it. + 3. For network scanning via a server connected device please see + the user manual. |