Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

ScanMole

github.com

  • Free plan
  • Linux
  • API
7.1 Club score Visit github.com

What ScanMole is

ScanMole is a free Linux scanning application for turning office and archival paperwork into searchable PDFs. It provides both a command-line engine and a GTK4/libadwaita desktop interface, so it can serve desktop operators as well as scripts or servers. Scanning supports duplex batch jobs, blank-page removal, OCR, automatic page sizing, deskewing, cropping and PDF/A output by default. The software detects page sizes and can straighten skewed pages. It works with SANE-compatible scanners, including driverless eSCL devices through sane-airscan, and the project lists devices from Brother, Canon, Epson and ScanSnap. The CLI includes filename templates, defined exit codes and a versioned JSON event protocol for integrations. ScanMole requires Python 3.12 or later and documents installation for Debian 13+, Ubuntu 24.04+ and Fedora. It is GPLv3-or-later software intended for paperwork, not photo scanning.

Who it suits

ScanMole suits Linux users digitizing office or archival paperwork, including people who need command-line or desktop workflows. The CLI can be used for server and scripting tasks, while the GUI targets desktop use.

Good to know, and what to watch

  • Duplex batch scanning and blank-page removal
  • OCR creates searchable PDF files
  • CLI supports JSON events and filename templates
  • Works with SANE and eSCL scanners
  • PDF/A output is enabled by default
  • Linux is the listed supported platform
  • Requires Python 3.12 or later
  • ScanSnap iX100 duplex scans only the front side
  • Not intended for photo or image scanning

The verdict

ScanMole combines desktop and scripted Linux scanning with OCR, batch handling and PDF/A output. Check scanner compatibility first, especially if using a ScanSnap iX100 for duplex work.

What the maker publishes

Automation
The CLI provides defined exit codes, filename templates and a versioned JSON event protocol for frontends or other integrations. source
Automation
The CLI provides defined exit codes, filename templates, and a versioned JSON event protocol. source
CLI and GUI
It includes a command-line scanning engine and a GTK4/libadwaita desktop frontend. source
Dependencies
ScanMole requires Python 3.12 or later and relies on distribution-provided tools including SANE, img2pdf, ocrmypdf and Tesseract. source
Installation requirements
ScanMole requires Python 3.12 or later and documents supported installation on Debian 13+, Ubuntu 24.04+, and Fedora. source
Integrations
The documented scanning and OCR toolchain includes SANE, img2pdf, ocrmypdf, and Tesseract. source
Intended use
The project is aimed at everyday office and archival paperwork rather than photo or image scanning. source
Intended users
The CLI can be installed alone for server or scripting use, while the GUI is intended for desktop use. source
Interfaces
ScanMole is available as a command-line scanning engine and a GTK4/libadwaita desktop frontend. source
Known device limitation
On the tested ScanSnap iX100, duplex requests scan only the front side and produce a warning. source
License
The project is licensed under GNU GPL version 3.0 or later. source
License
The project states that it is licensed under GNU GPL version 3.0 or later. source
Linux requirements
The project supports Debian 13 or later and Ubuntu 24.04 or later, and lists Fedora installation instructions. source
Maker
The repository says ScanMole was created and is maintained by foundata; its copyright notice names foundata GmbH. source
Page handling
It detects page sizes, crops pages, and can straighten skewed scans. source
Purpose
ScanMole turns office and archival paperwork into searchable PDFs using document scanners on Linux. source
Purpose
ScanMole scans office and archival paperwork into searchable PDFs and is designed for documents rather than photo or image scanning. source
Scanner compatibility
It works with scanners supported by SANE, including driverless eSCL devices through sane-airscan. source
Scanner support
ScanMole works with scanners supported by SANE, including driverless eSCL devices through sane-airscan. source
Scanning features
It supports duplex batch scanning, blank-page removal, OCR, automatic page sizing, deskewing and PDF/A output by default. source
Scanning features
Its defaults support duplex batch scanning, blank-page removal, OCR text, and PDF/A output. source
Support
The maintainers direct users to contribute or report scanner problems and device quirks through the project repository. source
Support
The project directs users to its contributing guide to report scanner problems and device quirks. source
Verified devices
The project lists tested devices from Brother, Canon, Epson and ScanSnap, including feeder and flatbed models. source

Checked against the maker's pages on 3 Oct 2026.