jonathanlurie / pyFlatplan

A Python command line tool to create a publisher flat plan from images. Useful if you export all the pages of your book/magazine as jpeg from InDesign.
3 stars 0 forks source link

pyFlatplan

What is a flatplan?

A flatplan is a layout quicklook for a book, a magazine or any kind of printed publication. It aims at showing all the pages at once in order to give a more global insight of the document. Then, the publisher evaluates easily his design.

How does pyFlatplan work?

It is a command line software, thus it has to run from a terminal. Then, it takes some arguments:

Argument Expected value Mandatory or Optional Default value Example
-input Image list or wildcard pattern madatory none /imgFolder/picture*.jpg
-output Output flatplan image optional flatplan.jpg myFlatplan.jpg
-thumb Thumbnail height in pixel optional 256 128
-column Number of columns (thumbs per lines) optional 5 4
-background Background color in hexadecimal optional "#EFFEFFEFF" "#FFF000000"
Don't forget to use quote marks!

What do you need to launch it?

pyFlatplan is coded with Python 2.7. It is usually installed on your OSX/Linux machine, but just in case, it's here.

Internally, the mosaic is made with ImageMagick, an open source software you need to install first. You can find it here.

How to launch it?

In a terminal:

cd /whereYouPutIt/pyFlatplan/
./pyFlatplan.py -input /myFolderFullOfImages/picture_*.jpg

To make it easier, you could add an alias to your .bashrc file:

alias flatplan='python /whereYouPutIt/pyFlatplan//pyFlatplan.py'

and then, you just have to call :

flatplan -input /myFolderFullOfImages/picture_*.jpg