xandao-dev / word-finder-bot

Find words in a word search game on TikTok

Word Finder Bot

It's a bot written to find words in a TikTok word search game that happened for a while. It uses OpenCV and OCR to find the words. Unfortunately it's only works on Windows and it requires BlueStacks to open TikTok.

Explore the docs »
Report Bug · Request Feature

Table of Contents

1. About The Project
   • Features
   • Built With
2. Getting Started
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact

About The Project

Features

• Read the target word from video using Tesseract OCR
• Read the matrix characters from video using OpenCV
• Reveal the position of the target word in the matrix

Built With

• python3 - A high-level, general-purpose programming language
• pynput - To read mouse and keyboard events
• openCV - Computer vision library
• pytesseract - Google's Tesseract OCR library
• pywin32 - Windows API for python
• fuzzywuzzy - String matching using Levenshtein distance

Getting Started

To get a local copy up and running follow these simple steps.

Installation

⚠️ Windows only ⚠️

1. Clone the repo

   git clone https://github.com/xandao-dev/word-finder-bot.git

2. Install dependencies

    cd word-finder-bot
    python3 -m pip install -r requirements.txt

Usage

1. Open TikTok on BlueStacks and find the word search game

2. Run the project

python3 bot.py

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Free software =)

Contact

Alexandre Calil - Linkedin - [e-mail]

Project Link: https://github.com/xandao-dev/word-finder-bot