ScanImageWebGUI/README.md

# ScanImageWebGUI #
### About ###
Josh North - josh.north@point808.com  
PHP Web GUI for scanimage/scanadf that is customized to be specific to certain scanners.  Inspired by http://www.andrewyager.com/blog/2007-10-08/web-based-sane-scanner-script but has morphed into something completely custom and basically scratch.  Leaving his credit in for the idea.  
I have no desire or motivation currently to make this work with anything else but feel free to modify/fork/push whatever you want to extend it and I promise I will attempt to maintain it.  
Currently this is coded purely for WAF purposes - heaven help my wife when it comes to technology.  

### NOTICE ###
This is useless for you except as a base to start from for your own scanner uness you happen to have my exact setup.  This is because there are so many available backends that to interface with the full range of scanimage/scanadf options would be a huge project- may as well create a full custom library and interface if you're going to do that, at least at this point.  Maybe in the future I can get the options from the scanimage/scanadf binary help files and somehow parse it in, but not right now.

### Requirements ###
* Compatible Scanners:  
* Epson WF-2540 (Networked mode - have to use saned with  iscan plugins - important!  Must use epkowa plugin)  
* HP DeskJet F4580 (Needs HPLIP drivers installed and must use net:hp address)  

### Installation ###
1.  Install Apache+PHP or NGINX+PHP-FPM or whatever you use.  It should work on pretty much any common web server with recent php.
2.  Unzip this somewhere in your web root or sub dir.
3.  Edit config.php to suit your setup
install sane-utils and pct-scanner-scripts


### Issues ###
1.  Try scanimage -L to get your scanner address
2.  HPLIP must run hp-setup script to get uri
3.  3.  Epson scanners must have epkowa driver (apt-get install iscan-network-nt from: http://download.ebz.epson.net/dsc/search/01/search/?OSC=LX)
4.  4. then edit /etc/saned/epkora.conf and add net printer
5.  epson or epson2 net drivers WILL NOT WORK FOR WF-series!
Update README.md 2015-01-02 17:07:57 -05:00			`# ScanImageWebGUI #`
			`### About ###`
			`Josh North - josh.north@point808.com`
			`PHP Web GUI for scanimage/scanadf that is customized to be specific to certain scanners. Inspired by http://www.andrewyager.com/blog/2007-10-08/web-based-sane-scanner-script but has morphed into something completely custom and basically scratch. Leaving his credit in for the idea.`
			`I have no desire or motivation currently to make this work with anything else but feel free to modify/fork/push whatever you want to extend it and I promise I will attempt to maintain it.`
			`Currently this is coded purely for WAF purposes - heaven help my wife when it comes to technology.`
Initial commit 2014-08-23 21:39:15 -04:00
Update README.md 2015-01-02 20:16:03 -05:00			`### NOTICE ###`
			This is useless for you except as a base to start from for your own scanner uness you happen to have my exact setup. This is because there are so many available backends that to interface with the full range of scanimage/scanadf options would be a huge project- may as well create a full custom library and interface if you're going to do that, at least at this point. Maybe in the future I can get the options from the scanimage/scanadf binary help files and somehow parse it in, but not right now.

Update README.md 2015-01-02 17:07:57 -05:00			`### Requirements ###`
			`* Compatible Scanners:`
			`* Epson WF-2540 (Networked mode - have to use saned with iscan plugins - important! Must use epkowa plugin)`
			`* HP DeskJet F4580 (Needs HPLIP drivers installed and must use net:hp address)`
Update README.md 2014-08-23 21:48:00 -04:00
Update README.md 2015-01-02 17:07:57 -05:00			`### Installation ###`
Update README.md 2014-08-23 21:48:00 -04:00			`1. Install Apache+PHP or NGINX+PHP-FPM or whatever you use. It should work on pretty much any common web server with recent php.`
			`2. Unzip this somewhere in your web root or sub dir.`
			`3. Edit config.php to suit your setup`
Update README.md 2015-01-02 20:22:32 -05:00			`install sane-utils and pct-scanner-scripts`

Update README.md 2014-08-23 21:48:00 -04:00
Update README.md 2015-01-02 17:07:57 -05:00			`### Issues ###`
Update README.md 2014-08-23 21:48:00 -04:00			`1. Try scanimage -L to get your scanner address`
			`2. HPLIP must run hp-setup script to get uri`
Update README.md 2015-01-02 20:50:30 -05:00			`3. 3. Epson scanners must have epkowa driver (apt-get install iscan-network-nt from: http://download.ebz.epson.net/dsc/search/01/search/?OSC=LX)`
			`4. 4. then edit /etc/saned/epkora.conf and add net printer`
			`5. epson or epson2 net drivers WILL NOT WORK FOR WF-series!`