https://github.com/ytax/github-username-checker
A basic tool written in Go to check multiple github usernames.
https://github.com/ytax/github-username-checker
checker github github-checker github-username github-username-checker username username-checker
Last synced: 28 days ago
JSON representation
A basic tool written in Go to check multiple github usernames.
- Host: GitHub
- URL: https://github.com/ytax/github-username-checker
- Owner: yTax
- Created: 2025-04-05T15:14:08.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-05T16:07:09.000Z (about 1 year ago)
- Last Synced: 2025-04-05T16:24:47.233Z (about 1 year ago)
- Topics: checker, github, github-checker, github-username, github-username-checker, username, username-checker
- Language: Go
- Homepage:
- Size: 5.16 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Github Username Availability Checker
This is a command-line tool written in Go that allows you to check the availability of github usernames.
This tool also has a session feature that allows you to save your progress so you dont have to recheck usernames you already checked previously.
This also, does not require you to provide a github API Key and handles the 30 second ratelimit that github has on quick GET requests.
## Features
- **Check Github Username availability**: Check if a Github Username is available or already claimed.
- **Session management**: Create new sessions or resume existing ones.
- **Progress tracking**: The tool remembers where it left off in case of interruptions.
- **Proxyless and AuthKey-Less**: This tool does not require you to provide proxies or an auth key.
- **Ratelimit Handling**: Automatically pauses and retries in 30 seconds when it get ratelimited.
## Installation
You can download the latest release of the Github Username Checker from the [releases page](https://github.com/yTax/Github-Username-Checker/releases) on GitHub. Simply go to the page, choose the latest version, and download the zip.
## Build Instructions
1. Clone the repository:
```bash
git clone https://github.com/yTax/Github-Username-Checker.git
```
2. Navigate to the project folder:
```bash
cd github-username-checker
```
3. Build the project:
```bash
go build
```
4. Run the program:
```bash
./main.exe
```
## Usage
When you run the tool, you'll be greeted with a menu to select your desired action. You can:
1. **Start a New Session**: Create a new session and begin checking usernames from a `targets.txt` file.
2. **Resume an Existing Session**: Choose an existing session to continue checking usernames.
3. **Exit**: Exit the program.
The program will check each username from your `targets.txt` file. If an username is available, it will be saved to the `output.txt` file. The program will also track your progress, so you can stop and resume at any time.
### Example Session Workflow
1. **Start a New Session**:
- If no session exists, the tool will create a new session automatically and read from the `targets.txt` file.
- By default, this file contains some random semi-og usernames, you can replace the content of this file with whatever you want the software to check.
- I also HEAVILY recommend you to run your list through a randomizer so that you arent checking the targets in alphabetic order.
2. **Resume a Session**:
- If sessions exist, you can select one to resume from where you left off.
- You will be shown the available sessions, and you can write it's name to select it.
## Known Issues
- The tool may take time depending on the number of usernames being checked. There's also a 30 second delay between around every 15-20 usernames, this is a restriction imposed by github. This 30 second restriction can be avoided if a feature to use API Keys and github's actual API to check the usernames instead of web-scrapping the profiles.
- If you delete the targets.txt file the tool will stop working because it wont be able to read the targets.
## To-do List
- [ ] Add support to github's API.
- [ ] Add an option to generate targets (3c, 3l, 4c and 4l usernames).
- [ ] Add discord webhook support.
- [ ] Add a turbo to quickly claim usernames. Proxy support might also be needed for this.
- [ ] Add some comments because i was too lazy to do it. I think the code is very easy to understand though.
- [ ] Add a web-interface.
## Credits
This tool was created by [ytax](https://github.com/ytax).
Feel free to contribute or open issues if you encounter any bugs or have suggestions for new features.
---
## Preview of the interface
---
Enjoy checking your usernames and have fun!