The project has two main functions:

• First, it has a follower notification system. In this system, people who recently followed you are sent to you in an email with their names and details.

• Second, it filters the users you follow who do not follow you back. After filtering, it can automatically unfollow unwanted users.

• The application uses 4 modules that are not built-in. If one or more of them are missing from your computer, you can install them with the following pip commands:

pip install pyinstaller
pip install pandas
pip install selenium
pip install yagmail

Note: To run these commands, PIP (Python Package Installer) must be installed on your system.

• The application needs 3 main components to work:

  • Source Codes: All source files are inside the src folder.

  src/

  
  
  • Driver: To connect the app with Chrome, you need a driver. You can download it from the internet or use the one included in the folder below:

  driver/

  
  
  • Required Data: You must download the folder that contains the necessary data. This folder includes the follower/following list and the JSON files required for the app to run

  Datas/

• You can download all of them directly to your computer by cloning the repository

git clone https://github.com/AlgorithmXplorer/Follower_Controller 

1. Save the data specified in the notes into the datas.json file inside the Datas folder
2. the file_funcs.py file, set the path variable to the path of the Datas folder.
   
   

• For normal use, the driver, data, and source files should be arranged as follows:

app/
|── main.py
|── bot.py
|── file_funcs.py
|── mail_funcs.py
|── timer.py
|
|──  datas/
|   |── users.json
|   └── datas.json
|
└── chromedriver.exe

• Once you have everything organized as above, just run the main.py file to start the application

• If you want to use it as an exe file, you only need to convert the source files into an exe file with pyinstaller. Run the following command in the Git Bash terminal.
  
  

pyinstaller --onefile --hidden-import="selenium;email;pandas;yagmail;imaplib;" main.py

Note: The Git Bash terminal must be opened in the same location as your source files.

• After completing this process, there should be a folder named dist. Take your main.exe file from there and follow the same steps as in Normal Usage, but use your exe file instead of the source files.

• License: MIT License → This license is very permissive; you can use, modify, and distribute the code without restriction, as long as you keep the license and copyright notice.
• Link: https://pypi.org/project/yagmail

• License: Apache License 2.0 → Under this license, you can freely use the software for commercial or open-source projects; the only requirement is to keep the copyright and license notices.
• Link: https://pypi.org/project/selenium

• License: BSD 3-Clause License → This license allows you to use and distribute the software widely, as long as you retain the source code notices.
• Link: https://pypi.org/project/pandas

• License: GNU General Public License v2 (GPLv2) […with an exception that allows you to build commercial applications with it] → With this license, you can distribute executable packages built with PyInstaller under your own license; but if you distribute changes made to PyInstaller’s source code, they must comply with GPL v2 terms.
• Link: https://pypi.org/project/pyinstaller