ImageToText

OCR (Optical Character Recognition) with Google's AI technology (Cloud Vision API).

The Vision API can detect and extract text from images.

Install

1. Download Python 3.6+ or follow this guide from Google Cloud.

2. Clone or download this repository.

3. Inside this repository, install the img2txt script from your terminal:

   pip install -e .
   

To uninstall: pip uninstall ImageToText

Usage

usage: img2txt [-h] [--url] [--document] [--languages LANGUAGES] [--full] [--confidence CONFIDENCE] [--key KEY] path

positional arguments:
  path                  path to image

optional arguments:
  -h, --help            show this help message and exit
  --url                 specify the path for an external image located on the Web (http:// or https://) or in Google Cloud Storage (gs://)
  --document            optimized for dense images
  --languages LANGUAGES, --language LANGUAGES
                        specify language hints from https://cloud.google.com/vision/docs/languages (comma separated)
  --full, --verbose     show full description (paragraphs, per-word confidence, boundaries...)
  --confidence CONFIDENCE
                        display possible mistakes for symbols with low confidence. Default: 0.6
  --key KEY             explicitly define the path to your service account JSON credentials

Authentication

Follow these instructions to set up a project with the Cloud Vision API enabled:

1. Select or create a Google Cloud Platform project. Project name suggestion: ImageToText

2. Enable Cloud Vision API for your project.

3. Create a service account and get your JSON credentials. Service account name suggestion: ImageToText

4. Make sure that billing is enabled for your project.

   Pricing is based on Google Cloud Vision API quota: 1,000 requests/month free

To authenticate your project you need to reference the service account JSON credentials you just downloaded. You have different options to do it, choose what you prefer:

service_account.json file

Rename the JSON you downloaded in step 3 to service_account.json and place it inside this repository folder.

--key parameter

Another option is to explicitly specify the --key parameter on every script execution:

img2txt abbey_road.jpg --key "/path/to/service_account.json"

Environment variable

You can also set the GOOGLE_APPLICATION_CREDENTIALS environmental variable:

<details> <summary><a><i>bash</i></a></summary> <p>Add to your <code>.bash_profile</code> file:</p>

<code>export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service_account.json"</code>

</details> <details> <summary><a><i>fish</i></a></summary> <p>Add to your <code>config.fish</code> file:</p>

<code>set -gx GOOGLE_APPLICATION_CREDENTIALS "/path/to/service_account.json"</code>

</details>

Examples

From file:

img2txt abbey_road.jpg

From any URL from the web:

img2txt --url https://cloud.google.com/vision/docs/images/abbey_road.JPG

Language: en

ABBEY
ROAD NW8
CITY OF WESTMINSTER

From Google Cloud Storage:

img2txt --url gs://cloud-samples-data/vision/ocr/sign.jpg

Language: en

WAITING?
PLEASE
TURN OFF
YOUR
ENGINE

With full description:

img2txt --full --url https://cloud.google.com/static/vision/docs/images/sign_small.jpg

Language: en

WAITING?
PLEASE
TURN OFF
YOUR
ENGINE
bounds: (52,143),(391,143),(391,343),(52,343)

WAITING
bounds: (59,143),(355,157),(353,197),(57,184)

?
bounds: (359,157),(391,158),(389,198),(357,197)

PLEASE
bounds: (211,214),(332,219),(331,241),(210,236)

TURN
bounds: (213,246),(299,249),(298,271),(212,268)

OFF
bounds: (313,250),(372,252),(371,273),(312,271)

YOUR
bounds: (211,281),(303,283),(303,304),(211,302)

ENGINE
bounds: (213,315),(336,318),(335,340),(212,337)

With dense documents:

img2txt --document --url https://i.imgur.com/7YhDbGf.jpg

Specify language hints (Optional):

img2txt --document --language "es" --url https://i.imgur.com/7YhDbGf.jpg

Language: es

Existen otras razones por las que masticar los alimentos como es debido es algo
esencial para nuestro bienestar. Según un fascinante estudio de investigación rea-
lizado en la Universidad de Gifu, en Japón, la masticación mejora la memoria al
reducir la liberación de las hormonas del estrés. La técnica de formación de ima-
gen por resonancia magnética (IRM) muestra que la masticación estimula el hi-
pocampo, el cual, a su vez, ayuda a controlar los niveles de hormonas del estrés en
sangre. El resultado es que el simple acto de masticar reduce tanto el estrés como
las hormonas del estrés, de modo que masticar bien los alimentos puede reducir
efectivamente el grado de ansiedad.
Los científicos japoneses descubrieron también que cuando faltan dientes o és-
tos se hallan en mal estado, se suele masticar menos. Ello hace que, acto seguido,
aumenten los niveles de hormonas del estrés. La conclusión de este estudio es que
una buena salud dental y una adecuada masticación son factores muy importantes
para conservar la memoria cuando envejecemos y para protegernos de los dañinos
efectos del estrés.
Una vez ha pasado por el esófago, el alimento entra en el estómago. Si lo que co-
memos contiene hidratos de carbono (azúcares complejos y almidones como los que
se encuentran

With full description:

img2txt --full --document --url https://i.imgur.com/7YhDbGf.jpg

<details> <summary>Output</summary> <pre><code>Language: es Existen otras razones por las que masticar los alimentos como es debido es algo esencial para nuestro bienestar. Según un fascinante estudio de investigación rea- lizado en la Universidad de Gifu, en Japón, la masticación mejora la memoria al reducir la liberación de las hormonas del estrés. La técnica de formación de ima- gen por resonancia magnética (IRM) muestra que la masticación estimula el hi- pocampo, el cual, a su vez, ayuda a controlar los niveles de hormonas del estrés en sangre. El resultado es que el simple acto de masticar reduce tanto el estrés como las hormonas del estrés, de modo que masticar bien los alimentos puede reducir efectivamente el grado de ansiedad. Los científicos japoneses descubrieron también que cuando faltan dientes o és- tos se hallan en mal estado, se suele masticar menos. Ello hace que, acto seguido, aumenten los niveles de hormonas del estrés. La conclusión de este estudio es que una buena salud dental y una adecuada masticación son factores muy importantes para conservar la memoria cuando envejecemos y para protegernos de los dañinos efectos del estrés. Una vez ha pasado por el esófago, el alimento entra en el estómago. Si lo que co- memos contiene hidratos de carbono (azúcares complejos y almidones como los que se encuentran SINGLE LINE Existen otras razones por las que masticar los alimentos como es debido es algo esencial para nuestro bienestar. Según un fascinante estudio de investigación realizado en la Universidad de Gifu, en Japón, la masticación mejora la memoria al reducir la liberación de las hormonas del estrés. La técnica de formación de imagen por resonancia magnética (IRM) muestra que la masticación estimula el hipocampo, el cual, a su vez, ayuda a controlar los niveles de hormonas del estrés en sangre. El resultado es que el simple acto de masticar reduce tanto el estrés como las hormonas del estrés, de modo que masticar bien los alimentos puede reducir efectivamente el grado de ansiedad. Los científicos japoneses descubrieron también que cuando faltan dientes o éstos se hallan en mal estado, se suele masticar menos. Ello hace que, acto seguido, aumenten los niveles de hormonas del estrés. La conclusión de este estudio es que una buena salud dental y una adecuada masticación son factores muy importantes para conservar la memoria cuando envejecemos y para protegernos de los dañinos efectos del estrés. Una vez ha pasado por el esófago, el alimento entra en el estómago. Si lo que comemos contiene hidratos de carbono (azúcares complejos y almidones como los que se encuentran PARAGRAPHS -- Existen otras razones por las que masticar los alimentos como es debido es algo esencial para nuestro bienestar. Según un fascinante estudio de investigación realizado en la Universidad de Gifu, en Japón, la masticación mejora la memoria al reducir la liberación de las hormonas del estrés. La técnica de formación de imagen por resonancia magnética (IRM) muestra que la masticación estimula el hipocampo, el cual, a su vez, ayuda a controlar los niveles de hormonas del estrés en sangre. El resultado es que el simple acto de masticar reduce tanto el estrés como las hormonas del estrés, de modo que masticar bien los alimentos puede reducir efectivamente el grado de ansiedad. Los científicos japoneses descubrieron también que cuando faltan dientes o éstos se hallan en mal estado, se suele masticar menos. Ello hace que, acto seguido, aument