ScanMole
github.com
- Free plan
- Linux
- API
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.