Skip to content

Commit

Permalink
add readme file
Browse files Browse the repository at this point in the history
  • Loading branch information
MadhushaPrasad committed Oct 30, 2024
1 parent b930149 commit 6daa59f
Showing 1 changed file with 58 additions and 0 deletions.
58 changes: 58 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# GitHub Follow Checker

## Overview

The **GitHub Follow Checker** is a simple Bash script that allows users to check their GitHub account to find users they follow who do not follow them back. It utilizes GitHub's API for seamless interaction and requires a personal access token for authentication.

## Features

- Reads GitHub username and personal access token from a file (`github.txt`).
- Prompts the user for their credentials if the file does not exist or contains invalid data.
- Fetches the list of users you are following and those who follow you back.
- Identifies and lists users that you follow but who do not follow you back.

## Prerequisites

- **Bash**: The script is written for Bash and should run on any Unix-like operating system with Bash support.
- **cURL**: The script uses `curl` to make API requests to GitHub.
- **jq**: This script requires `jq` for processing JSON data returned by the GitHub API. You can install it via package managers like Homebrew or APT:
- For macOS: `brew install jq`
- For Ubuntu/Debian: `sudo apt-get install jq`

## Usage

1. **Clone the Repository** (if applicable):
```bash
git clone https://github.com/yourusername/github-follow-checker.git
cd github-follow-checker
```

2. **Make the Script Executable**:
```bash
chmod +x github-follow-checker.sh
```

3. **Run the Script**:
```bash
./github-follow-checker.sh
```

4. **Input Your Credentials**:
- If `github.txt` exists, the script will read your GitHub username and personal access token from this file.
- If the file does not exist or contains invalid data, you will be prompted to enter your GitHub username and personal access token. The script will then save these credentials to `github.txt`.

5. **Review the Output**:
- The script will display users you follow who do not follow you back, or inform you that all your followers reciprocate.

## Important Notes

- **Personal Access Token**: You must create a personal access token with the necessary permissions to access your follower and following information. You can create a token by following [GitHub's documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).
- **Rate Limiting**: Be aware that GitHub’s API has rate limits. If you make too many requests in a short period, you may be temporarily blocked.

## License

This project is licensed under the MIT License. See the LICENSE file for more details.

## Author

[Madhusha Prasad](https://github.com/MadhushaPrasad)

0 comments on commit 6daa59f

Please sign in to comment.