Third-party software integration: OCR

From OpenKM Documentation
Revision as of 13:24, 13 January 2011 by Pavila (talk | contribs) (OpenKM 5.1 OCR configuration)

Jump to: navigation, search

Tesseract is an Open Source OCR engine adopted by Google. It works really well. The OCR natively can read TIFF documents and has hight ratio of recognition with images 300 dpi of resolution and converted to lineart (1 bit color).

If you are using a computer with Debian / Ubuntu, the installation simplifies a lot:

$ aptitude install tesseract-ocr

And

$ aptitude install tesseract-ocr-eng

If you want to add support for english language. You can also download Windows executables for tesseract-2.04 at http://code.google.com/p/tesseract-ocr/downloads/list.

Now you have to tell OpenKM to use this OCR application. Edit the file OpenKM.cfg:

$ vim OpenKM.cfg

And set the system.ocr property to the path of the tesseract executable:

system.ocr=/usr/local/bin/tesseract

For more info, go to http://code.google.com/p/tesseract-ocr/.

There is also another interesting free OCR application called OCRopus. It has many improvements over Tesseract but is on early development stage. Last released version (0.3.1) is quite usable and works very well but have to be compiled and actually is a difficult task. Visit http://code.google.com/p/ocropus/ for more info.

Compile from source code

You can download the source code from http://code.google.com/p/tesseract-ocr/ and compile yourself. Also download the language files you need and uncompress them in the same folder of the application.

$ sudo aptitude install build-essential libtiff4-dev
$ wget http://tesseract-ocr.googlecode.com/files/tesseract-2.04.tar.gz
$ tar xzvf tesseract-2.04.tar.gz
$ cd tesseract-2.04
$ ./configure --prefix=/opt/tesseract
$ make
$ wget http://tesseract-ocr.googlecode.com/files/tesseract-2.00.eng.tar.gz
$ tar xzvf tesseract-2.00.eng.tar.gz
$ sudo make install

The executable should be located at /opt/tesseract/bin/tesseract. More info about compilation at:

OpenKM 5.1 OCR configuration

Starting with OpenKM 5.1 you can choose between several OCR engines:

OCR Engine Text Extractor Image Formats
Tesseract 2.x com.openkm.extractor.Tesseract2TextExtractor TIFF
Tesseract 3.x com.openkm.extractor.Tesseract3TextExtractor TIFF PNG JPG GIF
Cuneiform com.openkm.extractor.CuneiformTextExtractor TIFF PNG JPG GIF

You can enable any of these text extractors adding it in the textFilterClasses param of the SearchIndex section in your repository.xml file.

External links