Game Pidgeon Bot

Python bot that automatically solves word games in Game Pigeon. Supports Word Hunt, Anagrams, and Word Bites.

Requirements

• macOS with iPhone mirroring capabilities
• Python 3.8+
• Dependencies in requirements.txt

Installation

1. Clone and install dependencies:

git clone https://github.com/condyl/game-pidgeon-bot.git
cd game-pigeon-bot
pip install -r requirements.txt

Usage

1. Mirror your iPhone to your Mac
2. Open Game Pigeon in iMessage and start a word game
3. Run the bot with optional arguments:

# Normal mode - finds all possible words
python main.py

# Realistic mode - limits scores to human-like levels
python main.py --realistic

# Target score mode - aims for a specific score
python main.py --target 10000

# Debug mode - saves screenshots and processing images
python main.py --debug

Project Structure

echo/
├── src/                    # Source code
│   ├── game/              # Game-specific modules
│   ├── config/            # Configuration files
│   └── utils/             # Utility functions
├── scripts/               # Utility scripts
├── tests/                 # Test files
├── word_lists/           # Word list files
└── requirements.txt      # Python dependencies

Features

• Automatic game board detection
• Word finding and drawing
• Support for all game modes
• Realistic mode for human-like scores
• Target score mode for custom score limits
• Debug mode for troubleshooting
• Optimized word selection and drawing

License

MIT License