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 <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

• 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 if you have any problem with the script.