/zotero-ocr

Zotero Plugin for OCR

Primary LanguageJavaScriptGNU Affero General Public License v3.0AGPL-3.0

Zotero OCR

LGTM Grade Latest release Release Date License Downloads latest release

This Zotero plugin adds the functionality to perform an OCR for the PDFs selected in Zotero. It can add a new PDF including the recognized text, a note with the recognized text only, and HTML (HOCR) file(s). Tesseract OCR is used for the text recognition itself.

Prerequisites

Installation

To install the extension:

  • Download the XPI file of the latest release.
  • In Zotero, go to Tools → Add-ons and drag the .xpi onto the Add-ons window.
  • Possibly, adjust the path to Tesseract in the add-on options.

Configuration

The configuration can be accessed under Tools → Zotero OCR Preferences:

Zotero OCR Preferences

Moreover, these options are saved as Zotero preferences variables, which are also available through the Config Editor.

Build and release

Run build.sh script, which creates a new .xpi file.

For a new release, run the script release.sh, push the code changes, publish a new release on GitHub and attach the .xpi file there.

Development

After any code changes one can build a new extension file by ./build.sh <version>. Then in Zotero go to Tools, Add-ons, Install Add-on From File... and choose there the newly created .xpi-file. Zotero will restart with the newly built add-on version.

If any error occurs then you will see more details in the Help, Report Error... dialog. For some debugging messages you can activate in Zotero the debugging in the Help, Debug Output Logging.

License

Zotero OCR is free and Open Source software. The source code is released under GNU Affero General Public License v3.