/ /_____ ____ / / /_ ____ _ __ / / __ \/ __ \/ / __ \/ __ | |// / // // / // / / // / // /> <

your personal image processing tools!

Installing / Building

This toolset is heterogeneous; some are written in C with bindings to libraries like opencv and tesseract, others are in the python scripting language and rely on python packages like numpy, python-opencv, pillow, and scipy.

Installing Python dependencies

For the python tools, it may be useful to create a "virtualenv". Otherwise you might eventually have trouble with version conflicts with other tools. Option A describes this approach. Alternatively, you can install the packages in your system (option B).

A. Installing Python dependencies in a venv

  1. Create one:

    virtualenv venv

  2. Activate it:

    source venv/bin/activate

  3. Use pip to install (nb you don't need sudo since you "own" the venv).

    pip install scipy pillow numpy

B. Installing Python dependencies to the system

sudo pip install scipy pillow numpy


Image Gradient

python python/imagegradient.py foo.png --output foo.gradient.png --svg foo.gradient.svg

Converts foo.png (input) into two outputs.


  • Viewer: Improve layers to show layers loading / loaded status (useful when browsing via cookbook)
  • Viewer: Add SVG layer support (technically possible ?! via img tag)... yes! using iframe ipv img
  • Viewer: Layer modes (such as masking ?!) ... and eventually export to other formats (SVG with image layers!)
  • Viewer: ?! Represent entire stacking as an SVG (to begin with!!!)