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: about 1 month 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 (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-20T16:00:04.000Z (9 months ago)
- Last Synced: 2025-09-20T18:15:19.459Z (9 months ago)
- Topics: github, githubunfollowertracker, python3, unfollowertracker, unfollowertrackerforgithub
- Language: Python
- Homepage:
- Size: 43 KB
- Stars: 5
- 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
- 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/s-r-e-e-r-a-j/GitGhost.git
```
```bash
cd GitGhost
```
## Dependencies
Make sure you have Python installed along with the following dependencies:
- **requests**
install it by
```bash
pip3 install requests
```
## Usage
**Run the script:**
```bash
python3 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.