ibu/rsnaps
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Simple web application for scanning documents to be installed locally
3 commits 1 branch 0 tags 532 KiB
Python 63.9%
HTML 27.1%
CSS 9%
Find a file
iburadempa 1ee58510df Fix PDF generation for non-vanishing collection path
2024-12-06 04:55:27 +01:00
static Add application 2024-11-21 13:23:24 +01:00
templates Add application 2024-11-21 13:23:24 +01:00
Pipfile Add application 2024-11-21 13:23:24 +01:00
Pipfile.lock Add application 2024-11-21 13:23:24 +01:00
README.md Add application 2024-11-21 13:23:24 +01:00
server.py Fix PDF generation for non-vanishing collection path 2024-12-06 04:55:27 +01:00

README.md

rsnaps

Capture a raw snap stream (scans or pictures) through a locally running webapp.

rsnaps is a simple webapp for local deployment on a machine with access to one or more scanner devices, or cameras with Canon CHDK. Users can start scan jobs and the scanned images will be put into a local directory with a serial number in the name. Users can see the list of previously scanned images and redo previous scans.

The scanned images are stored in PNG format and few metadata are added to them:

  • the name of the operator doing the scan
  • the ID of the unit/batch of material that is being scanned
  • the date and time of the scan
  • the device used for scanning

Limitations:

  • no concurrency: only one instance of rsnaps can run on a machine

  • A4 (181x256)

Prerequisites

Debian Linux with these packages installed

  • python3-sane
  • python3-aiohttp
  • python3-aiohttp-jinja2
apt install sane python3-sane python3-aiohttp python3-aiohttp-jinja2

PDF creation

Install jbig2 from https://github.com/agl/jbig2enc (cf. https://ocrmypdf.readthedocs.io/en/latest/jbig2.html).

You'll need these dependencies: TODO

Note: For jbig2 compression architecture amd64 is required.

OCR

apt install pngquant ocrmypdf and required tesseract language packages, e.g. tesseract-ocr-eng, tesseract-ocr-deu, ...

Page rotationa

apt install imagemagick

Setup

User and software

adduser --disabled-login --home /srv/rsnaps --ingroup scanner
su - rsnaps
git clone _______TODO_________ repo

... TODO

systemd integration

Put a systemd service unit in /etc/systemd/system/rsnaps.service:

[Unit]
Description=rsnaps local sanning service

[Service]
Type=
ExecStart=

[Install]
WantedBy=multi-user.target

systemctl daemon-reload
systemctl enable rsnaps.service
systemctl start rsnaps.service

Development

Useful resources:

TODO