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

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 <dummy>example.<tld>
  -k	exit the program when all tokens have been disabled
  -o string
    	output file, default: <domain>.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