Tesseract Open Source OCR Engine (main repository)
Go to file
2015-05-18 12:32:36 +01:00
android Add ability to build under android (without cube or scrollview). 2015-05-12 15:41:15 -07:00
api fix typo 2015-05-18 12:32:36 +01:00
ccmain added row attributes to hocr output 2015-05-17 22:13:59 +02:00
ccstruct Misc fixes missed from previous commits 2015-05-12 18:13:15 -07:00
ccutil extend ETEXT_DESC by progress_callback 2015-05-17 21:56:40 +02:00
classify fix VS2010 linking error 2015-05-14 14:24:55 +02:00
contrib fix svn:executable atribute, trailing spaces, version include 2013-11-03 17:24:00 +00:00
cube fix issue 1354 2015-04-15 22:37:58 +02:00
cutil More minor fixes from issues and cleanup 2014-01-10 01:38:00 +00:00
dict Font and classifier output structure cleanup. 2015-05-12 17:24:34 -07:00
doc update Doxyfile 2015-05-14 13:43:07 +01:00
java Cleaner fix for issue 1075 2014-01-30 02:20:06 +00:00
neural_networks/runtime Fixed a lot of compiler/clang warnings 2014-01-25 02:28:51 +00:00
opencl fix opencl build on OSX (issue 1272) 2014-08-18 09:37:21 +02:00
tessdata Fixes to make yesterday's changes compile 2015-05-13 09:58:59 -07:00
testing move testing images to testing directory 2014-03-07 12:32:10 +00:00
textord Removed debug logging that doesn't belong 2015-05-13 17:12:23 -07:00
training Fixed training build 2015-05-13 17:46:58 -07:00
viewer fix cygwin build (issue 1289) 2014-09-28 23:19:52 +02:00
vs2008 put info about (API) version; fix typo 2014-06-22 18:31:42 +00:00
vs2010 fix GIT_VER info in VS2010 2015-05-15 15:14:49 +02:00
wordrec Missing from 25d0968 2015-05-13 09:05:08 -07:00
.gitignore fix VS2010 build 2014-08-15 23:00:20 +02:00
AUTHORS Integrated patch to AUTHORS fixing issue 814 and adding more authors from the code 2013-01-03 18:02:49 +00:00
autogen.sh Fixed autogen.sh 2014-01-14 01:57:42 +00:00
ChangeLog Updated ChangeLog for 3.03 rc1 2014-02-05 00:53:56 +00:00
configure.ac fix autotools c++11 issue with disabled training 2015-05-14 14:25:49 +02:00
COPYING removed BOM form strngs.h, updated NSIS script and COPYING 2011-10-22 18:27:31 +00:00
INSTALL install data files; small fix of INSTALL, README; removed ABOUT-NLS (NLS not used at the moment) 2012-02-05 16:25:40 +00:00
INSTALL.GIT typo correction! fixes 1287 2014-09-06 10:57:56 +01:00
Makefile.am fix filemode; 2014-08-14 23:37:17 +02:00
NEWS top-skimming import from sf.net 2007-03-07 20:03:40 +00:00
README.md [infra] README -> README.md, links 2015-05-16 19:19:54 +02:00
ReleaseNotes Remaining misc changes for 3.02 2012-02-02 03:14:43 +00:00
tesseract.pc.in fix issue 1436 2015-04-12 16:38:03 +02:00

Note that this is a text-only and possibly out-of-date version of the wiki ReadMe, which is located at:

https://github.com/tesseract-ocr/tesseract/blob/master/README

Introduction

This package contains the Tesseract Open Source OCR Engine. Originally developed at Hewlett Packard Laboratories Bristol and at Hewlett Packard Co, Greeley Colorado, all the code in this distribution is now licensed under the Apache License:

  • Licensed under the Apache License, Version 2.0 (the "License");
  • you may not use this file except in compliance with the License.
  • You may obtain a copy of the License at
  • http://www.apache.org/licenses/LICENSE-2.0
  • Unless required by applicable law or agreed to in writing, software
  • distributed under the License is distributed on an "AS IS" BASIS,
  • WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  • See the License for the specific language governing permissions and
  • limitations under the License.

Dependencies and Licenses

Leptonica is required. (www.leptonica.com). Tesseract no longer compiles without Leptonica. Libtiff is no longer required as a direct dependency.

Installing and Running Tesseract

All Users Do NOT Ignore! The tarballs are split into pieces.

tesseract-x.xx.tar.gz contains all the source code.

tesseract-x.xx..tar.gz contains the language data files for . You need at least one of these or Tesseract will not work.

Note that tesseract-x.xx.tar.gz unpacks to the tesseract-ocr directory. tesseract-x.xx..tar.gz unpacks to the tessdata directory which belongs inside your tesseract-ocr directory. It is therefore best to download them into your tesseract-x.xx directory, so you can use unpack here or equivalent. You can unpack as many of the language packs as you care to, as they all contain different files. Note that if you are using make install you should unpack your language data to your source tree before you run make install. If you unpack them as root to the destination directory of make install, then the user ids and access permissions might be messed up.

boxtiff-2.xx..tar.gz contains data that was used in training for those that want to do their own training. Most users should NOT download these files.

Instructions for using the training tools are documented separately at Tesseract wiki https://github.com/tesseract-ocr/tesseract/wiki

Windows

Please use installer (for 3.00 and above). Tesseract is library with command line interface. If you need GUI, please check AddOns wiki page

TODO-UPDATE-WIKI-LINKS

http://code.google.com/p/tesseract-ocr/wiki/AddOns#GUI

If you are building from the sources, the recommended build platform is VC++ Express 2008 (optionally 2010).

The executables are built with static linking, so they stand more chance of working out of the box on more windows systems.

The executable must reside in the same directory as the tessdata directory or you need to set up environment variable TESSDATA_PREFIX. Installer will set it up for you.

The command line is:

tesseract imagename outputbase [-l lang] [-psm pagesegmode] [configfiles...]

If you need interface to other applications, please check wrapper section on AddOns wiki page:

TODO-UPDATE-WIKI-LINKS

http://code.google.com/p/tesseract-ocr/wiki/AddOns#Tesseract_3.0x

Non-Windows (or Cygwin)

You have to tell Tesseract through a standard unix mechanism where to find its data directory. You must either:

./autogen.sh ./configure make make install sudo ldconfig

to move the data files to the standard place, or:

export TESSDATA_PREFIX="directory in which your tessdata resides/"

In either case the command line is:

tesseract imagename outputbase [-l lang] [-psm pagesegmode] [configfiles...]

New there is a tesseract.spec for making rpms. (Thanks to Andrew Ziem for the help.) It might work with your OS if you know how to do that.

If you are linking to the libraries, as Ocropus does, please link to libtesseract_api.

If you get leptonica not found and you've installed it with e.g. homebrew, you can run CPPFLAGS="-I/usr/local/include" LDFLAGS="-L/usr/local/lib" ./configure instead of ./configure above.

History

The engine was developed at Hewlett Packard Laboratories Bristol and at Hewlett Packard Co, Greeley Colorado between 1985 and 1994, with some more changes made in 1996 to port to Windows, and some C++izing in 1998. A lot of the code was written in C, and then some more was written in C++. Since then all the code has been converted to at least compile with a C++ compiler. Currently it builds under Linux with gcc4.4.3 and under Windows with VC++2008. The C++ code makes heavy use of a list system using macros. This predates stl, was portable before stl, and is more efficient than stl lists, but has the big negative that if you do get a segmentation violation, it is hard to debug.

The most recent change is that Tesseract can now recognize 39 languages, including Arabic, Hindi, Vietnamese, plus 3 Fraktur variants is fully UTF8 capable, and is fully trainable. See TrainingTesseract for more information on training.

Tesseract was included in UNLV's Fourth Annual Test of OCR Accuracy. Results were available on http://www.isri.unlv.edu/downloads/AT-1995.pdf. With Tesseract 2.00, scripts were included to allow anyone to reproduce some of these tests. See TestingTesseract for more details.

About the Engine

This code is a raw OCR engine. It has limited PAGE LAYOUT ANALYSIS, simple OUTPUT FORMATTING (txt, hocr/html), and NO UI. Having said that, in 1995, this engine was in the top 3 in terms of character accuracy, and it compiles and runs on both Linux and Windows. As of 3.01, Tesseract is fully unicode (UTF-8) enabled, and can recognize 39 languages "out of the box." Code and documentation is provided for the brave to train in other languages. See code.google.com/p/tesseract-ocr for more information on training.