Skip to main content

Run character recognition on uploaded files

Project description

License: AGPL-3

OCR for documents

This module was written to make uploaded documents, for example scans, searchable by running OCR on them.

It supports all image formats Pillow supports for reading and PDFs.


To install this module, you need to:

  1. install tesseract and the language(s) your documents use
  2. if you want to support OCR on PDFs, install imagemagick
  3. install the module itself

On an Debian or Ubuntu system you would typically run:

$ sudo apt-get install tesseract-ocr imagemagick


To configure this module, go to:

  1. Settings/Technical/Parameters/System parameters and review the parameters with names document_ocr.*


By default, character recognition is done asynchronously by a cronjob at night. This is because the recognition process takes a while and you don’t want to make your users wait for the indexation to finish. The interval to run the cronjob can be adjusted to your needs in the Scheduled Actions menu, under ` Settings`. In case you want to force the OCR to be done immediately, set configuration parameter document_ocr.synchronous to value True.

Try me on Runbot

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.


The actual work


  • Odoo Community Association: Icon.


Do not contact contributors directly about help with questions or problems concerning this addon, but use the community mailing list or the appropriate specialized mailinglist for help, and the bug tracker linked in Bug Tracker above for technical issues.


Odoo Community Association

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

To contribute to this module, please visit

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for odoo8-addon-document-ocr, version
Filename, size File type Python version Upload date Hashes
Filename, size odoo8_addon_document_ocr- (21.5 kB) File type Wheel Python version py2 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page