IBSuite

Introduction

IBSuite stands for image book suite. It contains a set of tools to convert ebook in various format (pdf, chm, html) into a set of images, reformat the images (crop, embold, divide, etc), and assemble the result images into a new ebook.

Components

ibhtml2img

convert html to image with xulrunner

ibhtml2pdf

convert html to pdf with xulrunner

iblineparser

parser input image, extract line information

ibpdfinfo

get some meta-information from pdf file, such as title, author, table of contents etc.

ibpy

python module, which is the driver of the whole system, it uses above programs to convert input file to image, extract line information from image, dilate image, and re-assemble lines into a new image, generate output e-book.

ibtools

A set of utilities and tools, some of them are used internal by ibsuite, others are user command provided by ibsuite.

Usage

The most important command of ibsuite is ibreformat, the basic usage is as follow:

  ibreformat [options] <input file>

In most cases, something like following:

  ibreformat -o <output file> --iprof=<iprof> --oprof=<oprof> \
    --pprof=<pprof> <input file>

Where <input file> is input file name, <output file> is output file name, <iprof> is input profile, <oprof> is output profile, <pprof> is processing profile.

Available input/output/processing profiles are as follow:

• input profiles:
  • img: for scanned book
• output profiles:
  • prs505p: for Sony PRS505 in portrait mode
  • prs505l: for Sony PRS505 in landscape mode
• processing profiles:
  • divide2: divide one line into two line (a kind of simple reflow)
  • resize: Resize and dilate pages
  • repage: Re-page input book, without much other processing such as dilate.

For other command line options, please refer to "ibreformat -h".

Some useful command line option combinations

For scanned book on PRS505

  ibsuite -o <output file> -iprof=img -pprof=resize -oprof=prs505l <input file>

For chm file on PRS505:

  ibchm2imb <xxx>.chm

When it finishs, <xxx>.imb will be generated, then

  ibsuite -o <output file> -pprof=repage --oprof=prs505l <xxx>.imb

Download

Install

Currently, only Linux is supported, but I think it may work on some unix enviroment (including cygwin on Windows) after some work. Currently only install from source code is supported.

Pre-requirement

• gcc, g++, bash, make
• libfontconfig-dev, libnetpbm-dev, libgtk-dev
• python, python-imaging
• imagemagick
• for HTML/CHM support: python-chm, xulrunner
• for scanned book: unpaper

Build

./configure [--prefix=<prefix>]
make [PREFIX=<prefix>] [NO_XUL=1]

Install

# become root
make install [PREFIX=<prefix>] [NO_XUL=1] [NO_POPPLER=1]