Github Follower Manager

A professional and efficient tool to manage your GitHub network. Follow potential collaborators, companies, and industry leaders in bulk, and manage your following list with a modern graphical interface.

🚀 Overview

Those long hours of following your favorite developers on GitHub are now a thing of the past. Github Follower Manager allows you to automate the process safely, respecting GitHub's API limits while providing a premium user experience.

Key Features

• ✨ Modern GUI: Easy-to-use interface built with Python and Tkinter.
• 📥 Smart Extraction: Automatically extract usernames from GitHub links, README files, or JSON lists.
• 🛡️ Safety First: Implements random delays and automatic rate-limit handling to protect your account.
• 🔄 Unfollow Management: Quickly identify and unfollow users who don't follow you back.
• 💻 Windows Ready: Includes pre-configured scripts to compile into a standalone .exe.

---

🛠️ Installation

Option 1: Run from Source (All Platforms)

1. Clone the repository:

   git clone https://github.com/E1DIGITALPF/GithubFollowerManager.git
   cd GithubFollowerManager

2. Setup environment:

   python -m venv .venv
   # Windows
   .venv\Scripts\activate
   # Linux/macOS
   source .venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Run the App:

   python gui_github.py

Option 2: Automated Build (CI/CD)

The project is configured with GitHub Actions. Every time you push code to the main branch, a Windows executable is automatically generated. You can find it in the Actions tab of this repository under "Artifacts".

Option 3: Manual Build (Windows)

---

📖 How to Use

1. Credentials: Open the app and enter your GitHub Username and Personal Access Token. Ensure the token has user:follow and read:user permissions.
2. Import Users:
   • Paste GitHub profile links directly into the text area.
   • Load a list from a .json file.
   • Click Extract Users to refine the list.
3. Operations:
   • Follow Users: Start following the prepared list.
   • Unfollow (Non-followers): Clean your "Following" list by removing those who don't follow you back.
4. Logs: Monitor the process in real-time through the built-in log console.

---

📁 Project Structure

• gui_github.py: The heart of the application with the graphical interface.
• follow_github.py: Core logic for API interactions.
• build_win.bat & .spec: Configuration files for Windows compilation.
• images/: High-quality assets and icons.
• LICENSE: MIT License.

---

⚖️ License & Ethics

This project is licensed under the MIT License.

Disclaimer: This tool is designed for network building, not spamming. Users are responsible for adhering to GitHub's Terms of Service. The built-in protection mechanisms are designed to keep activity within reasonable limits.

---

🤝 Contributions

Contributions make the open-source community an amazing place to learn and create.

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

---

Developed with ❤️ by E1DIGITAL