https://github.com/s-r-e-e-r-a-j/gitghost
GitGhost is a powerful GitHub unfollowers tracking tool that helps you identify users you follow but who don’t follow you back.
https://github.com/s-r-e-e-r-a-j/gitghost
github githubunfollowertracker python3 unfollowertracker unfollowertrackerforgithub
Last synced: 4 months ago
JSON representation
GitGhost is a powerful GitHub unfollowers tracking tool that helps you identify users you follow but who don’t follow you back.
- Host: GitHub
- URL: https://github.com/s-r-e-e-r-a-j/gitghost
- Owner: s-r-e-e-r-a-j
- License: mit
- Created: 2025-02-27T17:16:30.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-27T18:27:35.000Z (4 months ago)
- Last Synced: 2025-02-28T00:50:12.373Z (4 months ago)
- Topics: github, githubunfollowertracker, python3, unfollowertracker, unfollowertrackerforgithub
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## GitGhost 👻
Find out who doesn’t follow you back on GitHub!
GitGhost is a powerful GitHub unfollowers tracking tool that helps you identify users you follow but who don’t follow you back.
## ✨ Features
- ✅ Find non-followers – See who isn’t following you back
- ✅ Uses GitHub API – Fast & reliable data fetching
- ✅ ANSI Colors – Clean and readable output
- ✅ Save Results – Option to save unfollowers list to a file
- ✅ Easy to Use – Just run, enter your username, and get results!
## 🛠️ Installation
Clone the repository and navigate to the project folder:
```bash
git clone https://github.com/yourusername/GitGhost.git
```
```bash
cd GitGhost
```
## 📦 Dependencies
Make sure you have Python installed along with the following dependencies:
- **requests**
install it by
```bash
pip install requests
```
## 🚀 Usage
**Run the script:**
```bash
python gitghost.py
```
## 🔑 Getting a GitHub Personal Access Token
GitGhost requires a **GitHub personal access token (PAT)** to authenticate API requests. Follow these steps to generate one:
### 📌 Step 1: Open GitHub Token Settings
Go to the **GitHub Personal Access Tokens** page:
🔗 [GitHub Token Settings](https://github.com/settings/tokens)
### 🛠️ Step 2: Generate a New Token
1. Click **"Generate new token (classic)"**.
2. In the **"Note"** field, enter a description (e.g., *GitGhost Token*).
### 🔒 Step 3: Set Token Permissions
- Under **"Select scopes"**, check the box for:
✅ **`read:user`** – Required to fetch your followers and following lists.
### ✅ Step 4: Generate & Copy the Token
1. Scroll down and click **"Generate token"**.
2. Copy the token and store it securely (you won’t see it again).
### 🚀 Step 5: Use the Token in GitGhost
- When prompted by GitGhost, paste your token to authenticate.
### ⚠️ Important Notes
- Never share your **GitHub token** with anyone.
- If your token is compromised, **revoke it** immediately and generate a new one.
- GitHub tokens **expire** based on the duration you set, so renew it if needed.
---
This guide ensures you have a **valid GitHub token** to use with GitGhost.
## What It Does:
- 1️⃣ Prompts for your GitHub username
- 2️⃣ Asks for your GitHub token
- 3️⃣ Fetches your followers and following lists
- 4️⃣ Shows users you follow who don’t follow you back
- 5️⃣ Lets you save the results to a file
## 📸 Screenshot
## 📜 License
This project is licensed under the MIT License.