1Installation Instructions 2************************* 3 41. Quick install: 5================= 6 7$ ./autogen.sh # only if you just cloned the git repository 8$ ./configure 9$ make 10$ make install 11 12 132. Step by step install on Linux >=2.6, with udev: 14================================================== 15 162.1. Install with your preferred package manager: 17 (a) the development environment for your Linux distribution 18 - mandatory: gcc, make, kernel header files, autoconf, autoconf-archive, 19 python(>=2.7) 20 - optional: git 21 (b) missing development packages 22 - libusb-dev or libusb-devel or libusb-compat-devel 23 - libusb-1.0.0-dev or similar 24 - libjpeg-dev or libjpeg8-dev or libjpeg-turbo-devel or turbojpeg-devel 25 - libpng-dev or similar 26 - libcurl4-gnutls-dev or similar 27 - libxml2-dev or similar 28 - libsnmp-dev or similar 29 - libpoppler-glib-dev or similar 30 312.2. Get the latest SANE backend from git: 32 You can download "daily git snapshot" from here: 33 34 http://www.sane-project.org/snapshots/ 35 36 If you prefer to use git, you can fetch a read-only copy of the git tree 37 with this command: 38 39 $ git clone https://gitlab.com/sane-project/backends.git 40 41 If you already are using a self compiled SANE backend and just fetched a 42 new copy of the git tree or if you patched some source files, there is no 43 need to follow the installation procedure again. You only need to make and 44 install libsane: 45 46 $ make && sudo make install 47 482.3. Configure, make and install latest SANE backend: 49 We install a new SANE dynamically linked shared object library in 50 /usr/local/lib beside your system's SANE library. 51 52 $ ./autogen.sh # only if you just cloned the git repository 53 $ ./configure 54 $ make && sudo make install 55 56 If you want to change some settings for your SANE installation, please 57 read the documentation on the website, the man pages and: 58 59 $ ./configure --help 60 61 Maybe you don't want to compile all scanners on your system, then you can 62 select the backends you need, e.g. epson2 and fujitsu: 63 64 $ ./configure BACKENDS="epson2 fujitsu" 65 66 You can search for your scanners backend names here: 67 68 http://sane-project.org/lists/sane-backends-cvs.html 69 702.3.1. SANE library: 71 Register new installed SANE dynamically linked shared object library. 72 73 $ sudo ldconfig -v | grep libsane 74 libsane.so.1 -> libsane.so.1.0.25 75 libsane.so.1 -> libsane.so.1.0.23 76 77 This example shows that the system first find version 1.0.25 and then 78 1.0.23. This is the correct order. 79 80 If your system first find the old version and then the new installed one, 81 then you must change the order for library paths in /etc/ld.so.conf or you 82 must create the new configuration file /etc/ld.so.conf.d/1-sane.conf. 83 84 $ echo "/usr/local/lib" | sudo tee -a /etc/ld.so.conf.d/1-sane.conf 85 86 Then you must repeat this step. 87 882.3.2. Localization file: 89 90 $ cd /usr/share/locale/<language>/LC_MESSAGES 91 $ sudo ln -sf /usr/local/share/locale/<language>/LC_MESSAGES/sane-backends.mo . 92 $ cd - 93 942.3.3. udev rules file: 95 96 $ sudo cp tools/udev/libsane.rules /etc/udev/rules.d 97 98 Reconnect your scanner to the USB bus to activate the new rules file. 99 1002.3.4. Use the scanner with normal user rights: 101 102 Your user must be a member of the group scanner. 103 104 $ cat /etc/group | grep scanner 105 scanner:x:107:<user> 106 107 Create a new group scanner, if it doesn't exist. 108 109 $ sudo addgroup scanner 110 111 Add an existing user to group scanner. 112 113 $ sudo adduser <username> scanner 114 115 After this you must logoff and login again. 116 1172.4. Test your scanner: 118 1192.4.1. Check the used backend version: 120 121 The programs must use the installed SANE backend version, e.g. 1.0.25. 122 123 $ scanimage -V 124 scanimage (sane-backends) 1.0.25git; backend version 1.0.25 125 126 This example shows that backend and scanimage are version 1.0.25. 127 128 $ /usr/bin/scanimage -V 129 scanimage (sane-backends) 1.0.23; backend version 1.0.25 130 131 This example shows that an old scanimage (1.0.23) uses the backend 1.0.25. 132 133 If you want to use xsane, start xsane and check the used version with 134 CTRL - i. 135 1362.4.2. Access scanner with normal user rights: 137 138 $ scanimage -L 139 140 If your scanner isn't recognised here, try this: 141 142 $ sudo scanimage -L 143 144 If this works, your user doesn't have the rights to access the scanner. 145 146 However, please check and redo the installation described above. 147 If this doesn't help, you can ask the mailing list 148 <sane-devel@alioth-lists.debian.net> for further support. 149 1502.4.3. Testscan: 151 152 $ cd ~ 153 $ scanimage > test.pnm 154 155 1563. Advanced Installation Information 157==================================== 158 159 Please read the documents INSTALL, README and README.linux. 160