Skip to content

Repository files navigation

TextGrabber

A powerful screen capture utility that extracts text from non-copyable sources using OCR technology.

TextGrabber Logo

🚀 Features

  • Quick Screen Capture: Capture any portion of your screen with a simple hotkey (default: Ctrl+Shift+S)
  • Smart Text Extraction: Advanced OCR processing using Tesseract
  • System Tray Integration: Convenient access through system tray icon
    • Left-click to capture
    • Right-click for menu options
  • Intelligent Text Processing:
    • Preserves file paths and URLs
    • Maintains special characters
    • Smart word spacing and formatting

📋 Requirements

  • Python 3.12+
  • Windows OS
  • Tesseract OCR installed (default path: C:\Program Files\Tesseract-OCR\tesseract.exe)

🔧 Installation

  1. Clone the repository:
git clone https://github.com/yourusername/TextGrabber.git
cd TextGrabber
  1. Install required Python packages:
pip install -r requirements.txt
  1. Install Tesseract OCR if not already installed:
    • Download from Tesseract Installer
    • Install to default location (C:\Program Files\Tesseract-OCR\)

💻 Usage

  1. Run the application:
python text_grabber.py
  1. The app will minimize to system tray
  2. Use the default hotkey (Ctrl+Shift+S) or left-click the tray icon to capture
  3. Select the area containing text
  4. Extracted text will be automatically copied to clipboard

⚙️ Configuration

Settings are stored in: %APPDATA%/TextGrabber/settings.json

Configurable options include:

  • Hotkey combinations
  • Tesseract OCR path
  • Text processing preferences

🛠️ Dependencies

  • pytesseract: OCR engine interface
  • Pillow: Image processing
  • tkinter: GUI components
  • keyboard: Hotkey management
  • pystray: System tray integration
  • pyperclip: Clipboard operations

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Tesseract OCR for the OCR engine
  • All contributors and users of TextGrabber

About

A powerful screen capture utility that extracts text from non-copyable sources using OCR technology.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors