Monitor and notify new subdomains found for a domain on Discord or/and Telegram.

Installation | Configuration | Usage | Running in the Background | References

Installation

$ git clone https://github.com/exampleuser/subhound.git
$ cd subhound
$ pip install -r requirements.txt

Configuration

[discord]
webhook_url =https://discord.com/api/webhooks/12345678910/qwertyuiopasdfghjklzxcvbnm
channel_name = #channel-name
[telegram]
bot_token =123456789:qwertyuiopasdfghjklzxcvbnm
chat_id =123456789

• Open config.ini file with any Text-Editor and Replace your own Values
• Remember to see the References Section for Configure you own Webhook and API keys.

Usage

To monitor a domain for new subdomains:

$ python subhound.py -d example.com

This will retrieve the current subdomains for example.com and save them to two files in a subdirectory named example.com_files. It will then continuously monitor for new subdomains and send notifications to the Discord or/and Telegram channel when new subdomains are found.

By default, SubHound checks for new subdomains every 60 minutes. You can adjust this interval with the -i option:

python subhound.py -d example.com -i 30

This will check for new subdomains every 30 minutes.

Running in the Background

This part for Bug Hunters and Security Reseachers

To run SubHound in the background so that it continues to run even if you close your VPS's SSH session, you can use the tmux command. tmux allows you to create and manage terminal sessions, and you can detach from a session to leave it running in the background.

To start a new tmux session:

$ tmux new-session -s subhound

This will create a new tmux session named "subhound". You can now run the SubHound command as usual:

$ python subhound.py -d example.com

To detach from the tmux session and leave it running in the background, press Ctrl-b and then d.

To reattach to the tmux session later:

$ tmux attach -t subhound

This will reattach to the "subhound" session and allow you to view the output of the SubHound command.

References

• Creating Discord webhook
• Creating Telegram bot

Credits

• Inspired by: GitHound and Sublert