Skip to main content

Tool to facilitate book digitization with the DIY Book Scanner

Project description Build status Coverage status Latest PyPI version Number of PyPI downloads

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 imlementing one of the available plugin classes.


spreads can be easily installed from PyPi:

$ pip install spreads

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


The following features are supported:

  • Configure the cameras for shooting (i.e. configure which camera is left, which is right)
  • Shoot with both cameras simultaneously
  • Download images from cameras and combine them into a single directory
  • 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 either further edit or run automatically
  • Automaitcally generate PDF and DJVU output
  • Interactive Wizard-Mode that handles the full workflow from image capturing to post-processing

The following features are on the agenda, but not implemented yet:

  • Automatically dewarp the scanned images using ppmunwarp



More documentation is available on readthedocs

Project details

Release history Release notifications

History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
spreads-0.3.2.tar.gz (3.8 MB) Copy SHA256 hash SHA256 Source None Aug 24, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page