Simple Web-based Interface for Scanner written in Python and JavaScript.
Project description
Simple Web-based Interface for Scanner
This is simple web-based interface for scanner. It allows share the scanner via IP address which makes it accessible by web browser. The frontend interface allows user to crop the image as well as browse previousely scanned images.
From technical perspective it is simply SANE scanimage wrapper. There are quite many things to do to make it production (see TODO section).
Requirements
- Linux
- SANE (Scanner Access Now Easy) properly configured (
scanimage
tool) - Python >= 3.8
- [Optionally] NPM (for frontend app building)
Install and run (local user)
pip install swis
swis --ip localhost --port 5520
❗IMPORTANT❗ Change the IP (localhost
above) to a proper host IP address if you want to access the scanner from other computers (or other devices).
Install and run (system service)
Prerequisites
This process requires root privileges, and you need to have Python>=3.8 installed. Also, there is the possibility that the server variants the system doesn't have pip
installed by default. In this case, execute below::
Fedora (and similar): sudo dnf install python3-pip
Ubuntu (and similar): sudo apt-get install python3-pip
Install and start service
sudo pip3 install swis
sudo swis --ip [HOST IP ADDRESS] --port 5520 service install -u [USER] -g [GROUP]
sudo swis service start
You can check the status by running: sudo swis service status
❗IMPORTANT❗ Change the IP ([HOST IP ADDRESS]
above) to a proper host IP address.
Screenshots
Welcome screen
Scanning parameters
Scanning in progress
Cropping scanned image
Side menu
List of scanned images
TODO:
- error handling
- pip package
- automatically add service with
systemctl
- better user interface (i.e. image remove button)
- move actions to vuex
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for swis-0.3.12-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2665086acde81933b638015fe7b342118ed5af177091127bd41a9a82a36a3569 |
|
MD5 | 9ebb4fcb9f8c15f0bd31eb5c51bd11d7 |
|
BLAKE2b-256 | 552d3fb32aee4e6e07d5df38513ad6e5710595e4ca5e1b52a1ba74539c7ea29d |