README.md

Project FADAIG: For Absolutely Destroying An iMessage Game

a.k.a. The Word Hunt Bot

There's actually much more potential for this than just a word hunt bot. The code published here is published in case anyone would find it useful for their own projects. See here for license.

Screenshots

(screen recording of the bot in action coming soon)

Parts required

Host device: A computer that can run the Python code that sends instructions to the Arduino connected to the target device

Target device: An iPad/iPhone that can run GamePidgeon

• Arduino Leonardo
• Serial-to-USB
• Jumper wires
• A micro-USB to USB cable/adapter for connecting the Arduino Leonardo's factory USB port to your target device

Usage

1. Install the src/worker code onto the Arduino Leonardo
2. Install the src/controller code onto the host device
3. Connect the Arduino Leonardo's factory USB to the target device
4. Connect the serial-to-usb cable
   • Connect the respective RX, TX, and GND pins (RX->TXD, TX->RXD, GND->GND)
   • Connect the other end of the serial-to-usb to the host device
5. Run the src/controller code on the host device
   1. Start running the code on the host device
   2. Wait for the program to load the word list
   3. Press "start" on target device
   4. Input the 4x4 board
   5. Profit

License

Copyright © 2023, Bryan Hu

This project is licensed under the GNU GPL v3+.

In short, this means you can do anything with it (distribute, modify, sell) but if you were to publish your changes, you must make the source code and build instructions readily available.

If you are a company using this project and want an exception, email me at [email protected] and we can discuss.