📷 GnomeOCR

Extract text from any screen region with one click or keyboard shortcut

A lightweight GNOME Shell extension that captures a screen area and copies the extracted text directly to your clipboard using Tesseract OCR.

☕ Support This Project

---

✨ Features

• ⌨️ Keyboard Shortcut — Press Super+Shift+T to capture text instantly
• 📷 One-Click Capture — Or click the panel icon to select a screen region
• 📋 Auto-Copy — Extracted text is automatically copied to clipboard
• 🌐 120+ Languages — Supports all Tesseract OCR languages
• ⚡ Lightweight — Minimal resource usage, no background processes
• 🎯 Panel Integration — Lives in your GNOME top panel

📦 Installation

Quick Install

git clone https://github.com/AITwinMinds/GnomeOCR.git
cd GnomeOCR
sudo bash install.sh

The installer will:

1. Install required dependencies (Tesseract OCR, gnome-screenshot)
2. Let you choose which language packs to install
3. Install the extension

Enable the Extension

After installation:

1. Restart GNOME Shell

   • X11: Press Alt+F2, type r, press Enter
   • Wayland: Log out and log back in

2. Enable the extension

   • Open the "Extensions" app
   • Toggle GnomeOCR ON

🚀 Usage

Keyboard Shortcut (Recommended)

Press Super+Shift+T → Draw a rectangle → Text is copied to clipboard!

Panel Menu

1. Click the 🔍 icon in the top panel
2. Select "📷 Capture Text"
3. Draw a rectangle around the text you want to capture
4. The text is automatically copied to your clipboard!

Change Language

Click the panel icon → 🌐 Language → Select your language

The extension auto-detects all installed Tesseract languages.

🌍 Language Support

Install additional languages during setup or manually:

# Single language
sudo apt install tesseract-ocr-deu  # German

# Multiple languages
sudo apt install tesseract-ocr-fra tesseract-ocr-spa tesseract-ocr-ara

# All languages (~2GB)
sudo apt install tesseract-ocr-all

📋 Popular Language Codes

Code	Language	Code	Language
eng	English	ara	Arabic
deu	German	fas	Persian
fra	French	hin	Hindi
spa	Spanish	jpn	Japanese
ita	Italian	kor	Korean
por	Portuguese	rus	Russian
chi-sim	Chinese (Simplified)	tur	Turkish
chi-tra	Chinese (Traditional)	vie	Vietnamese

🗑️ Uninstall

./install.sh --uninstall

🛠️ Requirements

• GNOME Shell 42 or later
• Tesseract OCR
• gnome-screenshot

☕ Support

If you find this extension useful, consider supporting the development!

📄 License

MIT License - see LICENSE for details.

---

Made with ❤️ by AITwinMinds