OCR Easy 🖼️➡️🔤

A simple and powerful OCR (Optical Character Recognition) library using Tesseract.js.

!npm !License !Downloads

---

✨ Features

✅ Extract text from images, URLs, and Base64
✅ Bulk image processing
✅ Image cropping & enhancement (grayscale, contrast)
✅ Supports multiple languages
✅ Fast & lightweight

---

📦 Installation

``sh
npm install ocr-easy
`

---

🚀 Usage

$3

`javascript
const { extractText } = require("ocr-easy");

extractText("test.png", { enhance: true })
.then(text => console.log("Extracted Text:", text))
.catch(err => console.error("Error:", err));
`

$3

`javascript
extractText("https://example.com/sample-image.png")
.then(text => console.log("Extracted Text:", text))
.catch(err => console.error("Error:", err));
`

$3

`javascript
const base64Image = "data:image/png;base64,iVBORw0KGg...";
extractText(base64Image)
.then(text => console.log("Extracted Text:", text))
.catch(err => console.error("Error:", err));
`

$3

`javascript
const { extractTextFromMultipleImages } = require("ocr-easy");

extractTextFromMultipleImages(["image1.png", "image2.jpg"], { enhance: true })
.then(results => console.log("Bulk OCR Results:", results))
.catch(err => console.error("Error:", err));
`

$3

`javascript
extractText("image.png", {
crop: { x: 50, y: 50, width: 200, height: 100 }
})
.then(text => console.log("Extracted Text:", text))
.catch(err => console.error("Error:", err));
`

$3

`javascript
extractText("image.png", { lang: "spa" }) // Spanish
.then(text => console.log("Extracted Text in Spanish:", text))
.catch(err => console.error("Error:", err));
`

---

🚀 React Usage Example

`javascript
import React, { useState } from "react";
import { extractText, extractTextFromMultipleImages } from "ocr-easy";

function OCRApp() {
const [image, setImage] = useState(null);
const [text, setText] = useState("");

const handleImageUpload = (event) => {
const file = event.target.files[0];
if (file) {
const reader = new FileReader();
reader.onload = async (e) => {
const base64Image = e.target.result;
const extractedText = await extractText(base64Image, { enhance: true });
setText(extractedText);
};
reader.readAsDataURL(file);
}
};

return (


);
}

export default OCRApp;
`

---


📺 Demo Video

Click the image below to watch the React Demo of OCR Easy:

![Watch the Demo](https://youtu.be/SBsa-Jk4j5E)

---

🛠️ Options

| Option | Type | Default | Description |
|---------|--------|----------|-------------|
| lang | String | "eng" | Language for OCR processing (e.g., "spa", "fra") |
| enhance | Boolean | false | Apply grayscale & contrast for better OCR results |
| crop | Object | null | Crop part of the image { x: 50, y: 50, width: 200, height: 100 } |

---

🌍 Supported Languages

- English (eng)
- Spanish (spa)
- French (fra)
- German (deu)
- Hindi (hin`)
- More languages can be added by configuring Tesseract.js.

---

📜 License

This project is licensed under the MIT License.

---

📫 Contributing

Pull requests are welcome! Feel free to contribute or report issues.

⭐ Star this project if you found it useful!

---