mathieuruellan/scanservjs repository overview

⁠scanservjs

scanservjs is a simple web-based UI for your scanner. It allows you to share a scanner (using SANE) on a network without the need for drivers or complicated installation. It can save to TIF, JPG, PNG and PDF with varyings compression settings. It also allows for configurable output conversions through configuration.

Copyright 2016 Sam Strachan⁠

⁠Requirements

• SANE
• ImageMagick
• nodejs

⁠Installation notes

For an easy docker-based install (assuming that SANE supports your scanner out-of-the-box on Debian) use the following commands. Please note that by default, configuration and scanned images are stored within the container and will be lost if you recreate it. If you want to map your scanned images then specify the volume mapping option -v /local/path/:/app/data/output/

docker pull sbs20/scanservjs:latest
docker rm --force scanservjs-container 2> /dev/null
docker run -d -p 8080:8080 --restart unless-stopped --name scanservjs-container --privileged sbs20/scanservjs:latest

(--privileged is required for the container to access the host's devices, to allow it to talk to the scanner)

scanservjs will now be accessible from http://$host:8080/

If you want to install the latest staging branch (this may contain newer code)

docker pull sbs20/scanservjs:staging
docker rm --force scanservjs-container 2> /dev/null
docker run -d -p 8080:8080 --restart unless-stopped --name scanservjs-container --privileged sbs20/scanservjs:staging

More installation options:

• Manual installation notes here⁠
• Development notes⁠
• Configuring the scanner and SANE⁠

⁠Why?

This is yet another scanimage-web-front-end. Why? It originally started as an adaptation of phpsane - just to make everything a bit newer, give it a refresh and make it work on minimal installations without imagemagick - that version is still available⁠ but is no longer maintained. Then, I just wanted to write in node, and it's been a labour of love ever since.

⁠Roadmap

• Configuration page for debugging set up assisting new users
• Multi-language support

⁠Acknowledgements

• This project owes a lot to phpsane⁠

⁠More about SANE

• http://www.sane-project.org/⁠