Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gwen001/github-subdomains
Find subdomains on GitHub.
https://github.com/gwen001/github-subdomains
bugbounty github go golang pentesting security-tools subdomains
Last synced: 1 day ago
JSON representation
Find subdomains on GitHub.
- Host: GitHub
- URL: https://github.com/gwen001/github-subdomains
- Owner: gwen001
- License: mit
- Created: 2020-07-24T06:54:29.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-03-28T15:47:06.000Z (over 1 year ago)
- Last Synced: 2024-11-30T14:16:19.838Z (12 days ago)
- Topics: bugbounty, github, go, golang, pentesting, security-tools, subdomains
- Language: Go
- Homepage:
- Size: 47 MB
- Stars: 676
- Watchers: 12
- Forks: 99
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
- WebHackersWeapons - github-subdomains - subdomains?label=%20)|[`subdomains`](/categorize/tags/subdomains.md)|[](/categorize/langs/Go.md)| (Weapons / Tools)
- awesome-hacking-lists - gwen001/github-subdomains - Find subdomains on GitHub. (Go)
README
github-subdomains
Find subdomains on GitHub.
---
## Description
This Go tool performs searches on GitHub and parses the results to find subdomains of a given domain.
## Install
```
go install github.com/gwen001/github-subdomains@latest
```
or
```
git clone https://github.com/gwen001/github-subdomains
cd github-subdomains
go install
```
## Usage
```
$ github-subdomains -h
Usage of github-subdomains:
-d string
domain you are looking for (required)
-e extended mode, also look for example.
-k exit the program when all tokens have been disabled
-o string
output file, default: .txt
-raw
raw output
-t string
github token (required), can be:
• a single token
• a list of tokens separated by comma
• a file (.tokens) containing 1 token per line
if the options is not provided, the environment variable GITHUB_TOKEN is readed, it can be:
• a single token
• a list of tokens separated by comma
```
If you want to use multiple tokens, you better create a `.tokens` file in the executable directory with 1 token per line
```
token1
token2
...
```
or use an environment variable with tokens separated by comma:
```
export GITHUB_TOKEN=token1,token2...
```
Tokens are disabled when GitHub raises a rate limit alert, however they are re-enable 1mn later.
You can disable that feature by using the option `-k`.
## Todo
- change the order of the extra searches ?
- ?
## Changelog
**20/09/2022**
- fix regexp for subdomains
**25/09/2020**
- quick mode added
- tokens can be read from any file
**23/09/2020**
- fixed an issue in the api call (params name)
- added binary
**12/08/2020**
- improved clean function
**06/08/2020**
- max_page set forced to 10 to save 1 request for every search
- new banner (easier to maintain)
- removed `_` from the regexps
- extended regexp fixed
- improved cleaning function
**05/08/2020**
- added an option to exit the program when all tokens have been disabled instead of waiting
- rate limited tokens are disabled for 1mn then re-enabled
- removed options for languages and noise
- better page management
- panic errors handled
**04/08/2020**
- moved default languages and noise to source code
- added an option for languages and noise
- bug fixed in searches with language and noise (empty keyword)
- added search signature to avoid duplicate searches with noise
- file loading rewritten
- preview image added
**03/08/2020**
- fixed delay changed 100 -> 200
- removed useless debug messages
---
Feel free to [open an issue](/../../issues/) if you have any problem with the script.