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.
