forked from hean01/iscan
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
196 lines (147 loc) · 7.37 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
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.