/mrz-scanner

Detect, ocrize and parse (client or server side) the Machine Readable Zone of passports and other documents

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

mrz-scanner

Detect, ocrize and parse (client or server side, or from command line) the Machine Readable Zone of passports and other documents

Using mrz-detection written for NodeJS by Daniel Kostro and Michaël Zasso.

LICENSE

Copyright (c) 2018-2019 ALSENET SA

Author(s):

      Luc Deschenaux <luc.deschenaux@freesurf.ch>

 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU Affero General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU Affero General Public License for more details.

Quickstart

Web demo

The web demo is at https://alsenet-labs.github.io/mrz-scanner/dist/index.html (nothing is uploaded)

Web demo from filesystem

The code is "same-origin friendly". That means it can be run in the browser from the filesystem (no web server required), with eg:

Use the prebuilt static version

git clone https://github.com/alsenet-labs/mrz-scanner
xdg-open mrz-scanner/dist/index.html

Rebuild and run the static version

git clone https://github.com/alsenet-labs/mrz-scanner
cd mrz-scanner
npm install
gulp dist
xdg-open dist/index.html

Web demo from web server

You can build the scripts, start a web server and open a browser, with eg:

git clone https://github.com/alsenet-labs/mrz-scanner
cd mrz-scanner
npm start

Command line tool

You can also scan documents from the command line using this repository or the latest published npm package. On success the result will be stored in a file suffixed by ".mrz.json" along the original image by default.

Using this repository

git clone https://github.com/alsenet-labs/mrz-scanner
cd mrz-scanner
npm install .
mrz2json [ -d|--dest-dir <directory> ] <png_or_jpg_or_tiff> [...]

Using the latest published npm package

npm install -g mrz-scanner
mrz2json [ -d|--dest-dir <directory> ] <jpg_or_png_or_tiff> [...]

Supported image formats

Supported image formats The following formats can be loaded by image-js:

  • PNG (8 or 16 bits, color or greyscale, with or without alpha)
  • JPEG
  • TIFF (8 or 16 bits, greyscale)