Skip to main content

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).


  • Linux
  • SANE (Scanner Access Now Easy) properly configured (scanimage tool)
  • Python >= 3.8
  • [Optionally] NPM (for frontend app building)

Install and run from pip (RECOMMENDED)

pip install swis
python -m 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).

Build app


Run (from source code)

  1. Download the latest release from:
  2. Run below command (extracts, installs dependencies and executes):
mkdir -p swis && \
tar -C swis -xvzf swis.tar.gz && \
cd swis && \
pip install -r requirements.txt && \
python --ip localhost --port 5520
  1. Then you can access the scanner through http://localhost:5520

❗IMPORTANT❗ Change the IP (localhost above) to appropriate host IP address of the host if you want to access the scanner from other computers (or other devices).


Welcome screen

Scanning parameters

Scanning in progress

Cropping scanned image

Side menu

List of scanned images


  • error handling
  • pip package
  • automatically add service with systemctl
  • better user interface (i.e. image remove button)
  • move actions to vuex

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

swis-0.3.3.tar.gz (15.1 kB view hashes)

Uploaded Source

Built Distribution

swis-0.3.3-py2.py3-none-any.whl (14.9 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page