Skip to content

Josuex09/spreads

 
 

Repository files navigation

image

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.

Quickstart

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

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
  • 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

Requirements

Documentation

More documentation is available on readthedocs

About

Workflow assistant for camera-based book digitization

Resources

License

Stars

Watchers

Forks

Packages

No packages published