||4 years ago|
|.gitignore||6 years ago|
|LICENSE||6 years ago|
|README.md||4 years ago|
|fbopt||4 years ago|
|spectrscan||4 years ago|
An unintrusive frontend of scanimage which acts as a paper to pdf converter suitable for texts.
Table of contents
Remember that the output file supplied in the command line can either be an empty file or an existing PDF file. In the latter case, newly scanned documents will be automatically appended to the tail of the file.
Scan in lineart mode, from the automatic document feeder, with a resolution of 600 DPI, using Unpaper and with image enhancing options on the output file
Same as before but for double sided paper
./spectrscan -o out.pdf
Scan in colour, with a resolution of 300 DPI, using the flatbed, on the output file
./spectrscan -m Color -r 300 -s Flatbed out.pdf
Disable unpaper (same procedure for imagemagick):
./spectrscan -ufalse out.pdf ./spectrscan --unpaper_options=false out.pdf
If the scanned text results unreadable try using the
Gray mode instead
of the default
Currently, passing options to unpaper and imagemagick is not working. You should edit the options directly in the script. By default, contrast is set at a very high level. You can edit
imagemagick_options="-normalize -level 70%,100%,1.0"
with something like:
imagemagick_options="-normalize -level 20%,100%,1.0"
and see what happens.
You can call spectrscan from any directory by modifying the shell's path. You can then call spectrscan:
cd <specrscan repo directory> PATH="$PATH:$(pwd)" cd <document destination directory> spectrscan <whatever>
Usage: spectrscan [OPTIONS] OUTFILE An unintrusive frontend of scanimage which acts as a paper to pdf converter suitable for texts. If the ouput file exists then the new scanned documents will be added as the tail of the existing one. The default system scanner is used. Options: -h, --help print this help -i, --imagemagick-options pass options to ImageMagick to post-process the documents -m, --mode scan in Color, Lineart, Gray or whatever supported method --list-modes list all possible scan modes -o, --odd-even toggle preserve the order in double sided paper: scan a batch of papers one side, then the other -r, --resolution page resolution in DPI --list-resolutions list all possible resolutions -s, --source scan from the ADF, Flatbed or whatever supported method --list-sources list all possible sources -u, --unpaper-options pass options to unpaper to post-process the documents Current enabled options: --imagemagick-options="-contrast-stretch 0.5%x10% -compress lzw" --mode "Lineart" --odd-even="false" --resolution "600" --source "ADF" --unpaper-options="true" The magic values of "true" and "false" can be used to enable or disable: --odd-even=<value> --unpaper-options=<value> (if "false", unpaper is disabled) Dependencies: GNU Bash; GNU Core Utilities; Gawk; SANE; ImageMagick unpaper; PDFtk; GNU Parallel; Netpbm Exit status: 0 if OK, 1 if an error occurred. Copyright © 2017 Franco Masotti. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
Parallel immage processing (based on the number of processor cores) cuts the time by a factor of
#coresafter page scanning has taken place. This is very effective for a large number of pages.
Odd-even page numbers scanning.
Basic unpaper and ImageMagick post-processing.
Relevant links and ideas
Dependencies and explanations
- Scipting language interpreter
- Basic software like
- Basic software like
- Filter some output from miscellaneous commands
- Scanner software
- PNM to PDF converter and image processing tool
- Remove issues with scanned images (paper margins, etc...)
- Execute image post processing jobs in parallel
Fix the newly scanned immages by truncating the unnecessary parts. This is mostly useful when scanning from the ADF
In my case I have an HP Officejet 2620 connected via USB to a server as a network printer/scanner. Scanning using the "Flatbed" option poses no problems, while using the "ADF", the image is somehow corrupted and it contains a black box adjacent to the scanned document. If I try to post process the image with unpaper and/or ImageMagick serveral errors are reported. The only solution I found was to use
pamfix -truncate. I still haven't determined the cause of this problem
A "libre" version of the package is available in Parabola GNU/Linux-libre, described like this:
A toolkit for manipulation of graphic images, without nonfree parts and patent issues
- Options to add
- Number of pages to scan
- Option for prompting for each page to scan
- Better default options to pass to unpaper
- OCR (training (GOCR)? + text file outputs)
- options: keep PDF, keep txt, keep both
- Better parallel processing
- Watch inotifies for a new out*.pnm would be faster than post-processing in parallel
Origin of the name
The name comes from spectrwm
If pdftk repots that PDF files are missing this is probably due to the
new ImageMagick security policies. Remove
This is the error returned by
convert: attempt to perform an operation not allowed by the security policy `PDF' @ error/constitute.c/IsCoderAuthorized/408.
Copyright (C) 2017 frnmst (Franco Masotti) email@example.com
spectrscan is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.