TesserNet 0.8.0

dotnet add package TesserNet --version 0.8.0
NuGet\Install-Package TesserNet -Version 0.8.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="TesserNet" Version="0.8.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add TesserNet --version 0.8.0
#r "nuget: TesserNet, 0.8.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install TesserNet as a Cake Addin
#addin nuget:?package=TesserNet&version=0.8.0

// Install TesserNet as a Cake Tool
#tool nuget:?package=TesserNet&version=0.8.0

NuGet
<a href="https://www.buymeacoffee.com/cptwesley" target="_blank"><img src="https://shields.io/badge/Support%20Me-Buy%20Me%20A%20Coffee-yellow?style=flat&logo=data:image/png;base64,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" alt="Buy Me A Coffee" ></a>

TesserNet

TesserNet provides high level bindings for Tesseract in .NET. The library comes with all required native libraries and a trained English model, meaning you don't need any additional setup to get the library up and running! Additionally, the library provides a simple Tesseract instance pooling system (through the TesseractPool class) so you can carelessly make asynchronous OCR invocations.

Limitations

Windows is currently the only version that doesn't require installing extra dependencies. For Linux distributions it is necessary to install tesseract-ocr. For distributions that use apt as the package manager (e.g. Ubuntu, Debian, Raspbian) this can be done using sudo apt-get install tesseract-ocr. Linux support is new and experimental. Problems might arise due to tesseract-ocr not being available or because the found version is too old. iOS is currently not yet supported.

Downloads

TesserNet
TesserNet for System.Drawing
TesserNet for ImageSharp
TesserNet for SkiaSharp

License

This product includes Leptonica, which is available under a "BSD 2-clause" license.
This product includes Tesseract, which is available under a "Apache Version 2.0" license.

Usage

When using on Linux, make sure tesseract-ocr has been installed on your system.

There are a few example project available for you to try out in the src directory. Note that the TesserNet.Example.System.Drawing example uses .NET Framework, meaning it will only run on Windows.

To start off, one first needs to add the following import:

using TesserNet;

One can then create a Tesseract instace:

Tesseract tesseract = new Tesseract();

With that instance one can now perform OCR.

string result = tesseract.Read(...);

By default, the following Read methods are provided:

string Read(byte[] data, int width, int height, int bytesPerPixel);
string Read(byte[] data, int width, int height, int bytesPerPixel, int rectX, int rectY, int rectWidth, int rectHeight);
Task<string> ReadAsync(byte[] data, int width, int height, int bytesPerPixel);
Task<string> ReadAsync(byte[] data, int width, int height, int bytesPerPixel, int rectX, int rectY, int rectWidth, int rectHeight);

Additionally, if one prefers to use System.Drawing, ImageSharp or SkiaSharp, it is possible to also add a dependency to TesserNet.System.Drawing, TesserNet.ImageSharp or TesserNet.SkiaSharp respectively. Adding either of these dependencies adds the following Read methods:

string Read(Image image);
string Read(Image image, Rectangle rectangle);
Task<string> ReadAsync(Image image);
Task<string> ReadAsync(Image image, Rectangle rectangle);

Furthermore, when trying to use concurrency, it might be useful to have a look at the TesseractPool class:

TesseractPool pool = new TesseractPool();

The TesseractPool class provides a pooling mechanism for running the OCR on multiple Tesseract instances, without having to manually deal with all the different instances. The class has the following methods:

string Read(byte[] data, int width, int height, int bytesPerPixel);
string Read(byte[] data, int width, int height, int bytesPerPixel, int rectX, int rectY, int rectWidth, int rectHeight);
Task<string> ReadAsync(byte[] data, int width, int height, int bytesPerPixel);
Task<string> ReadAsync(byte[] data, int width, int height, int bytesPerPixel, int rectX, int rectY, int rectWidth, int rectHeight);

And when either of the aforementioned image processing bridging libraries are present:

string Read(Image image);
string Read(Image image, Rectangle rectangle);
Task<string> ReadAsync(Image image);
Task<string> ReadAsync(Image image, Rectangle rectangle);
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on TesserNet:

Package Downloads
TesserNet.System.Drawing

Provides extension methods for TesserNet when using System.Drawing.

TesserNet.ImageSharp

Provides extension methods for TesserNet when using ImageSharp.

TesserNet.SkiaSharp

Provides extension methods for TesserNet when using SkiaSharp.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.8.0 3,449 10/11/2022
0.7.0 1,390 4/13/2022
0.6.0 999 11/9/2021
0.5.1 1,726 10/6/2021
0.5.0 585 10/6/2021
0.4.0 580 10/4/2021
0.3.0 952 10/21/2020
0.2.0 660 10/18/2020
0.1.0 738 10/17/2020