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

Find words in a word search game on TikTok
https://github.com/xandao-dev/word-finder-bot

bot ocr opencv python python3

Last synced: 15 days ago
JSON representation

Find words in a word search game on TikTok

• Host: GitHub
• URL: https://github.com/xandao-dev/word-finder-bot
• Owner: xandao-dev
• License: mit
• Created: 2022-01-21T18:13:55.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2022-09-06T01:18:35.000Z (about 2 years ago)
• Last Synced: 2024-10-10T12:50:42.733Z (about 1 month ago)
• Topics: bot, ocr, opencv, python, python3
• Language: Python
• Homepage:
• Size: 7.21 MB
• Stars: 0
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        





  
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

  


    


      About The Project

      


        
Features

        
Built With

      

    

    


      Getting Started

      


        
Installation

      

    

    
Usage

    
Roadmap

    
Contributing

    
License

    
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](https://www.python.org/) - A high-level, general-purpose programming language

* [pynput](https://pypi.org/project/pynput/) - To read mouse and keyboard events

* [openCV](https://opencv.org/) - Computer vision library

* [pytesseract](https://pypi.org/project/pytesseract/) - Google's Tesseract OCR library

* [pywin32](https://github.com/mhammond/pywin32) - Windows API for python

* [fuzzywuzzy](https://github.com/seatgeek/thefuzz) - String matching using Levenshtein distance

## Getting Started

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

### Installation

:warning: Windows only :warning:

1. Clone the repo

   ```sh

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

   ```

2. Install dependencies

   ```sh

	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

  ```sh

  python3 bot.py

  ```

## Roadmap

See the [open issues](https://github.com/xandao-dev/word-finder-bot/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](./LICENSE.md) for more information.

Free software =)

## Contact

Alexandre Calil - [Linkedin](https://www.linkedin.com/in/xandao-dev/) - [[email protected]](mailto:[email protected])

Project Link: [https://github.com/xandao-dev/word-finder-bot](https://github.com/xandao-dev/word-finder-bot)