Configuration files for abusenius/insaned to enable custom actions when pressing scanner's buttons.

Part of a project involving NTC's CHIP compputer to turn my Canon LiDE 210 into a standalone, networked scanner in an effort to go paperless.

Note that the insaned executable has been compiled for ARM, it won't run on any other platform. If you need to build it for yourself, see the insaned project repo for instructions.

• Depends on libsane, insaned, and imagemagick
• Depends on textcleaner and GNU parallel >= 20161122 if option toggled ($CLEAN_PAGES=true in etc/insaned/events/extra)
• If needed, install the latest GNU parallel with (wget -O - pi.dk/3 || curl pi.dk/3/) | bash
• Copy or symlink the files in their respective directories (paths relative to /)
• Tweak the default settings in etc/default/insaned
• Run the setup.sh script (or symlink and mv manually)
• Register insaned as a systemd service: systemctl daemon-reload && systemctl enable insaned && systemctl start insaned (cf note below if enable doesn't work)
• Check it's running: systemctl status insaned

Debian 8 ships with systemd 215 which has trouble enabling symlinked services (See systemd/systemd#1515.) This has been fixed in systemd 232 (systemd/systemd#3806), but jessie-backports only has 230. If this ever changes, install from backports with apt-get -t jessie-backports install systemd. In the meantime, copy the service file: cp etc/systemd/system/insaned.service /etc/systemd/system/insaned.service

Once the scanner is detected by libsane (sane-find-scanner; scanimage -L), it will execute the script from /etc/insaned/events/ that matches the button pressed.

For reference, on the LiDE 210, these are the buttons mappings:

Load the page in the scanner, press the PDF button. When done scanning, place the next page and press PDF again. After the document's last page is scanned, press the PDF ▶︎| button to assemble every page into a single PDF document.

The resulting PDF file will be saved at /scans/ and named YYYYMMDD_HHMMSS.pdf. Documents are scanned at 300 dpi grayscale.

This isn't implemented yet

Use the Autoscan button. The document will be saved as a 600 dpi TIFF file in /scans/ under YYYYMMDD_HHMMSS.tif.

Scan the page with the Copy button. It will make a black and white 300 dpi scan of the page, resample it to fit on a single page, and send it to the printer.

Note that a printer must be configured for this to work. If your printer doesn't have ARM drivers (cough cough, Brother), or doesn't offer Linux drivers, try Generic PCL 6/PCL XL.

Not implemented yet.

Kept at /var/log/insaned.log, can be overridden in each script. To see what's happening in real time, tail -F /var/log/insaned.log.

Eahch log entry follows the following format: <timestamp> | <insaned button name>: <log message>

• GNU parallel by O. Tange: https://www.gnu.org/software/parallel/
• textcleaner by Fred Weinhaus, free for non-commercial use only. More details and a ton of other useful ImageMagick scripts at http://www.fmwconcepts.com/imagemagick
• insaned by Abusenius

• A cron job to reap documents older than X days in /scans/ to avoid clutter
• Another cron job to git pull periodically to update the code
• Export /scans/ as a NFS share
• Figure out how the email function will be implemented