Botz

Botz is a Chrome/Firefox extension that detects suspicious bot activity.
The Big Bots Project is a social experiment aimed at identifying bots and sock puppets in the social platforms feeds.

Hat tip to noam-r & Yuval Adam for leading the entire project.
Thanks to anyone who participated in botim.online Hackathons!

Visit https://botim.online to support the project and to submit bot reports.

Table of Contents

• Development
• Using the extension
  • Chrome
  • Firefox
• Contributing
  • Prerequisites
  • Submitting Changes
• Contributors

Development

1. Clone to your computer.

2. Install dependencies:

   yarn install

3. Building the extension:

   yarn build
   
   # or if you want to watch for file changes
   yarn watch

4. Creating a zip file:

   yarn zip

Using the extension

Chrome

1. Access chrome://extensions.
2. Enable Developer mode.
3. Load the extension with Load unpacked.
4. You must reload the extension after each change in the code.

Firefox

1. Access about:debugging.
2. Select Enable add-on debugging.
3. Load the extension with Load Temporary Add-on...
4. You must reload the extension after each change in the code.

• The extension is running automatically when Twitter is accessed in the browser.

Contributing

• Having a problem with the extension? Please open an Issue.
• Willing to take your chances with some issue, please post a comment to prevent collision with someone else.

If you would like to contribute some feature/bugfix to the project, complete the following steps:

Prerequisites

1. Bake something and eat it. 🍞
2. Install Node.js.
3. Install Yarn.
4. If you're using VSCode, please install the extensions: TSLint and Prettier - Code formatter.

Submitting Changes

1. Create a fork of this repository.
2. Create a branch (git checkout -b feat/check_bot).
3. Commit your changes (git commit -am "test: add some tests").
4. Push to the branch (git push origin feat/check_bot)
5. Open a Pull Request.

Contributors

Thanks goes to these wonderful people (emoji key):

Noam R 💼 🖋 📋 🤔 🛡️ 📢

Yuval Adam 💼 🖋 📋 🤔 🛡️ 📢

Eran Shmil 🤔 🚇 💻

Yuval Larom 🤔 💻

Akiva 🤔 🚇 💻

Eran Cohen 💻

TomKizaru 💻

This project follows the all-contributors specification. Contributions of any kind welcome!