spreads 0.1

Introduction

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 shooting 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 beforehand, or by inspecting the output and applying your modifications.

spreads is meant to be fully customizable. This means, adding support for plugins is made as painless as possible. Support for plugins that can either hook into the various commands or add new ones is on the agenda, stay tuned!

Quickstart

spreads can be easily installed from PyPi:

$ pip install git+git://github.com/jbaiter/spreads.git@master

spreads offers an interactive wizard that guides you through the whole process:

$ spread wizard ~/my_scanning_project

Features

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

• Create a ScanTailor project file that the user can either further edit or run automatically

• 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

• Do color-correction using a graycard and imagemagick

Requirements

• Python 2.7

• The clint library (used for the console interface)

• The pillow library (used to obtain EXIF information and rotate images)

• The pyusb library (used to obtain information about attached cameras)

• Two cameras running CHDK (development was done using two Canon A2200s, no further cameras were tested, but should work in theory)

• A version of ptpcam modified for CHDK in /usr/bin

• gphoto2

• An up-to date version of ScanTailor-enhanced

Documentation

More documentation is available on readthedocs