A C# library that reads the machine readable zone of passports, ID cards and visas from photos. Everything is managed code, including the OCR: no native binaries, no ML runtime, one small dependency for image decoding. Give it a JPEG, get back parsed fields with every ICAO 9303 check digit verified.
The image above is the library's own detection output on a synthetic specimen (the Anna Maria Eriksson example from the ICAO 9303 spec). No real documents appear in this repository.
dotnet add package Dissimilis.MrzScanner
Targets netstandard2.0 and net8.0.
using Dissimilis.MrzScanner;
MrzResult result = await MrzScanner.Default.ReadAsync("passport.jpg");
if (result.IsValid)
{
var doc = result.Document!;
Console.WriteLine($"{doc.DocumentNumber} {doc.PrimaryIdentifier}, born {doc.BirthDate}");
}
else
{
foreach (MrzIssue issue in result.Issues)
Console.WriteLine(issue);
}Read/ReadAsync accept a file path, byte array, stream, or raw pixels via MrzImage if you decode images yourself. Bad input never throws; you get a result explaining what went wrong.
The result carries more than the fields:
IsValidis true only when every present check digit verified.Confidenceestimates the fraction of characters read correctly, calibrated on labeled documents.FieldConfidencebreaks that down per field, so you can trust the checksum-backed document number while re-checking a shaky name.Regiontells you where the MRZ sits in the image and how the image needs to be rotated to bring it upright. Sideways and upside-down photos are handled.Rawhas the exact recognized characters for auditing.
Single frames from a phone camera are often half readable: motion blur in one, glare in the next. MrzVideoSession folds frames together, voting per character, so the combined read can be valid even when no single frame was.
Camera previews arrive as YUV, and for MRZ reading only the luma plane matters, so you can hand the buffer over as is. No JPEG round trip, no color conversion:
var session = new MrzVideoSession();
void OnPreviewFrame(byte[] nv21, int width, int height)
{
session.Feed(MrzImage.FromNv21(nv21, width, height));
if (session.IsStable)
Show(session.Best!.Document!);
else
ShowGuidance(session.LastFrameHints);
}FromNv12 and FromI420 cover the other common camera layouts, and FromGrayscale8/FromBgra32 and friends take decoded buffers. Camera buffers usually arrive in sensor orientation; pass the rotation the camera reports and the reader handles it: MrzImage.FromNv21(buffer, width, height, 0, rotationDegrees). IsStable turns true once the result is fully valid and corroborated by more than one frame. Call Reset() between documents.
LastFrameHints says what to fix when a frame did not read: TooSmall means move closer, CutOff means the band touches the frame edge, plus Blurry, Glare, LowContrast and NoMrzDetected. The same hints appear on MrzResult.CaptureHints for still photos. A frame with a clean MRZ typically reads in under 100 ms; a frame without one returns quickly so the next frame gets its turn.
If you want a viewfinder overlay before committing to a full read, LocateMrz finds MRZ-shaped bands in a few milliseconds without recognizing characters:
foreach (MrzRegion region in reader.LocateMrz(frame))
DrawOverlay(region.Left, region.Top, region.Width, region.Height);// Stills: exhaustive search (default). Video: bounded per-frame cost.
var reader = new MrzScanner(new MrzScannerOptions
{
MaxImageDimension = 2000,
SearchEffort = MrzSearchEffort.SingleFrame,
});
// Text you already have, no image involved.
MrzResult parsed = MrzParser.ParseText("P<UTOERIKSSON<<ANNA<MARIA...");The locator finds bands of dense, monospaced text by their edge profile. Candidate bands are segmented into character cells on the OCR-B pitch and matched against glyph templates; competing grid placements are judged by how well the templates actually fit. Uncertain characters are then resolved by the MRZ's own structure: check digits, character classes per position, and date plausibility arbitrate between close candidates. All formats from ICAO 9303 are supported: TD1, TD2, TD3, MRV-A and MRV-B.
The recognizer only knows the 37-character MRZ alphabet in OCR-B; it is not a general OCR. Glyphs below roughly 6 px of pitch are at the edge of what template matching can do. Tilt up to about 8 degrees is detected and corrected automatically, on top of the 90/180/270 degree orientations; extreme perspective is not. Chip reading and the visual inspection zone are out of scope.
MIT