Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Book digitization workflow assistant

Project Description
.. image::

.. image::
:alt: Build status

.. image::
:alt: Coverage status

.. image::
:alt: Latest PyPI version

*spreads* is a tool that aims to streamline your book scanning workflow.
It takes care of every step: Setting up your capturing devices, handling
the capturing process, downloading the images to your machine,
post-processing them and finally assembling a variety of output formats.

Along the way you can always fine-tune the auto-generated results either
by supplying arguments or changing the configuration beforehand, or by
inspecting the output and applying your modifications.

*spreads* is meant to be fully customizable. This means, `adding support for
new devices` is made as painless as possible. You can also hook into any of the
*spread* commands by implementing one of the available `plugin hooks` or even
`implement your own custom sub-commands`.

First, make sure you have installed all of the requirements (see below).
Once this is done, *spreads* can be easily installed from PyPi::

$ pip install spreads

To select your desired plugins and configure your devices::

$ spread configure

*spreads* offers an interactive wizard that takes you from a physical book
to a digitized version in one single workflow with minimal user input::

$ spread wizard ~/my_scanning_project

* Shoot with both cameras **simultaneously**, directly storing the images
in a single directory on your computer in the right order.
* Automatically rotate the images and optionally adjust the white balance
(if a gray card has been used during shooting).
* Create a ScanTailor project file that the user can customize as desired.
* Generate PDF and DJVU files with hidden text layers
* Interactive Wizard-Mode that handles the full workflow from image
capturing to post-processing, either from the command-line or via graphical

* Python 2.7 with pip_ installed
* libusb with headers installed
* exiftool_
* An up-to date version of ScanTailor-enhanced_

* For the GUI: PySide_
* For CHDK cameras: An up-to-date version of chdkptp_
* For the ScanTailor plugin: ScanTailor-enhanced_
* For PDF output: pdfbeads_
* For DJVU output: djvubind_
* For OCR: tesseract_

More documentation is available on readthedocs_

.. _adding support for new devices:
.. _plugin hooks:
.. _implement your own custom sub-commands:
.. _ppmunwarp:
.. _readthedocs:
.. _pip:
.. _ScanTailor-enhanced:
.. _pdfbeads:
.. _djvubind:
.. _exiftool:
.. _chdkptp:
.. _tesseract:
.. _PySide:
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
spreads-0.4.1.tar.gz (43.5 kB) Copy SHA256 Checksum SHA256 Source Dec 25, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting