WordBomb OCR

A Python + Tesseract OCR tool for automating word detection in the game WordBomb

Overview

This project is a WordBomb tool that uses Tesseract OCR to detect the letter prompts in-game and automatically suggest words from a dictionary. It can also auto-type the best match with a single key press (F8).

It was built as a personal passion project and is not guaranteed to be actively maintained. The code is open-source, so you are free to fork and extend it.

Features

• Modern CustomTkinter dark dashboard UI
• Two OCR regions: Region A (required), Region B (optional)
• Supports 2- and 3-letter prompts with fast n-gram indexing
• Intelligent OCR caching to avoid redundant scans
• Auto-correction heuristics for common misreads (I/l, O/U, etc.)
• Top-K word suggestions with clickable buttons
• F8 hotkey to instantly auto-type the best suggestion
• Dictionary loader (.txt file, one word per line)
• Live OCR loop with adjustable interval

Installation

1. Install Python 3.10+ and pip.

2. Clone this repository:

   git clone https://github.com/DynamiteDan/wordbomb-cheat.git
   cd wordbomb-cheat

3. Install dependencies:

   pip install -r requirements.txt

4. Download and install Tesseract OCR:

   * Windows builds: UB Mannheim Tesseract * Either add tesseract.exe to your PATH or place it in vendor/tesseract/.

FORTUNATELY THIS STEP IS NO LONGER REQUIRED, JUST RUN THE PYTHON FILE ON AN IDE OF YOUR CHOICE

Usage

Run:

python app.py

Controls:

• Select OCR Region A (required)
• Select OCR Region B (optional)
• Load dictionary → choose a .txt wordlist
• Start Live OCR → continuously detect prompts
• Press F8 → auto-type the current best word

Notes

• Bundles Tesseract OCR (Apache License 2.0) — copyright © Google and contributors.
• Currently requires you to supply your own dictionary (.txt). A sample is included.
• A compiled .exe release is planned so Tesseract is bundled automatically.

Disclaimer

This was created as a passion project.

• It is not intended to be used to ruin other players’ experiences in real games.
• Use responsibly — I am not responsible for how you choose to use it.

Roadmap

• Cleaner UI (Tkinter with dark theme)
• Improved OCR accuracy (dual region, retries, correction)
• Bundle Tesseract into .exe with PyInstaller
• Add packaged releases with wordlists

License

This project bundles Tesseract OCR, licensed under the Apache License 2.0. Please see the LICENSE file for details.