PHPackages                             estey/evernote-ocr - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. estey/evernote-ocr

AbandonedArchivedLibrary[API Development](/categories/api)

estey/evernote-ocr
==================

Use the Evernote API to perform text recognition (OCR) on an image file.

v0.2.0(11y ago)11422MITPHPPHP >=5.4

Since Oct 13Pushed 11y ago1 watchersCompare

[ Source](https://github.com/BradEstey/evernote-ocr)[ Packagist](https://packagist.org/packages/estey/evernote-ocr)[ Docs](http://www.bradestey.com/projects/evernote-ocr)[ RSS](/packages/estey-evernote-ocr/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (8)Versions (8)Used By (0)

Evernote OCR
============

[](#evernote-ocr)

[![Latest Stable Version](https://camo.githubusercontent.com/7e3c5ff20834880513d0bef5a13f19b5e29249391c228f839a740a02e76c1bc6/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65737465792f657665726e6f74652d6f63722e737667)](https://packagist.org/packages/estey/evernote-ocr) [![Build Status](https://camo.githubusercontent.com/7db386b0d32cc5e3843edf6c0a08b816ba7fb5880523830f4081150471dc6d32/68747470733a2f2f7472617669732d63692e6f72672f4272616445737465792f657665726e6f74652d6f63722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/BradEstey/evernote-ocr) [![Coverage Status](https://camo.githubusercontent.com/4435537155de932da281ed0c1279101f23e14690f4fa5c147be5b561fb1ca144/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f4272616445737465792f657665726e6f74652d6f63722e737667)](https://coveralls.io/r/BradEstey/evernote-ocr?branch=master)

This is an unofficial library for using the [Evernote](https://evernote.com) API as a means for image text recognition. Please be advised that using the Evernote API solely for the purpose of OCR for your application is a violation of the [API License Agreement](http://dev.evernote.com/documentation/reference/api_license.php).

Installation
------------

[](#installation)

Install this package through [Composer](https://getcomposer.org) by editing your project's `composer.json` file to require `estey/evernote-ocr`.

```
{
    "require": {
        "estey/evernote-ocr": "0.2.*"
    }
}
```

Then, update Composer:

```
composer update

```

To get a new Evernote Dev Token, sign in to your account and use this link:

Usage
-----

[](#usage)

```
use Estey\EvernoteOCR\Client;

$client = new Client('YOUR DEV TOKEN');
$response = $client->recognize('path/to/image.jpg');

print_r($response);
```

The recognize method will return an array of `TextBlock` objects, each with an array of text recognition options. Each `Text` object contains the recognized text and a confidence score of 0-100. Each `TextBlock` contains the X and Y coordinates where the text was found and the width and height of the text block in pixels.

```
Array
(
    [0] => Estey\EvernoteOCR\TextBlock Object
        (
            [x] => 51
            [y] => 82
            [width] => 307
            [height] => 35
            [options] => Array
                (
                    [0] => Estey\EvernoteOCR\Text Object
                        (
                            [text] => SEPTEMBER
                            [confidence] => 91
                        )

                )

        )

    [1] => Estey\EvernoteOCR\TextBlock Object
        (
            [x] => 370
            [y] => 87
            [width] => 128
            [height] => 30
            [options] => Array
                (
                    [0] => Estey\EvernoteOCR\Text Object
                        (
                            [text] => 2014
                            [confidence] => 77
                        )

                    [1] => Estey\EvernoteOCR\Text Object
                        (
                            [text] => 201 a
                            [confidence] => 35
                        )

                )

        )

)

```

Laravel Filesystem Adapter
--------------------------

[](#laravel-filesystem-adapter)

If you're using [Laravel](http://laravel.com), there is a service provider available. Open `app/config/app.php`, and add the service provider to the `providers` array. You'll also need to add your [Evernote Dev Token](https://www.evernote.com/api/DeveloperToken.action) to your `.env` file with the key set to `EVERNOTE_DEV_TOKEN`.

```
'Estey\EvernoteOCR\Providers\Illuminate\EvernoteOCRServiceProvider'

```

Use it like so:

```
$client = App::make('evernote_ocr', ['path/to/image.jpg']);
$response = $client->recognize();

print_r($response);
```

Flysystem Adapter
-----------------

[](#flysystem-adapter)

The Evernote OCR package comes with a built in adapter to support the [Flysystem](http://flysystem.thephpleague.com) filesystem library.

```
use Estey\EvernoteOCR\Client;
use Estey\EvernoteOCR\FileAdapters\FlysystemFileAdapter;
use League\Flysystem\Filesystem;
use League\Flysystem\Adapter\Local as Adapter;

$filesystem = new Filesystem(
    new Adapter(__DIR__ . '/path/to/root/')
);

$client = new Client('YOUR DEV TOKEN');
$file = new FlysystemFileAdapter('path/to/image.jpg', $filesystem);
$response = $client->recognize($file);

print_r($response);
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](https://github.com/bradestey/evernote-ocr/blob/master/LICENSE) for more information.

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

7

Last Release

4270d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/65050e2971f866e7a534a49d752b1d885db693dbd86f2c2ec4ab164d0b5f5723?d=identicon)[Brad Estey](/maintainers/Brad%20Estey)

---

Top Contributors

[![BradEstey](https://avatars.githubusercontent.com/u/578665?v=4)](https://github.com/BradEstey "BradEstey (36 commits)")

---

Tags

evernoteevernote-apievernote-ocrocrphptext-recognitionOCRtext recognitionevernoteevernote ocr

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/estey-evernote-ocr/health.svg)

```
[![Health](https://phpackages.com/badges/estey-evernote-ocr/health.svg)](https://phpackages.com/packages/estey-evernote-ocr)
```

###  Alternatives

[thiagoalessio/tesseract_ocr

A wrapper to work with Tesseract OCR inside PHP.

3.1k3.8M33](/packages/thiagoalessio-tesseract-ocr)[evernote/evernote-cloud-sdk-php

Evernote Cloud SDK for PHP

146151.9k3](/packages/evernote-evernote-cloud-sdk-php)[evernote/evernote

Evernote PHP SDK

25228.6k](/packages/evernote-evernote)[veryfi/veryfi-php

veryfi sdk for php

16191.7k](/packages/veryfi-veryfi-php)[ddeboer/tesseract

A wrapper for the Tesseract OCR engine

22136.7k](/packages/ddeboer-tesseract)[clarifai/clarifai-php-grpc

Clarifai PHP gRPC client

1229.3k](/packages/clarifai-clarifai-php-grpc)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)