{"id":13846083,"url":"https://github.com/Cyber-Guy1/Subdomainer","last_synced_at":"2025-07-12T04:30:55.979Z","repository":{"id":43778699,"uuid":"380237928","full_name":"Cyber-Guy1/Subdomainer","owner":"Cyber-Guy1","description":"Automated tool for domains \u0026 subdomains gathering","archived":false,"fork":false,"pushed_at":"2023-08-24T07:32:12.000Z","size":1087,"stargazers_count":178,"open_issues_count":4,"forks_count":51,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-18T13:40:37.666Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cyber-Guy1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-06-25T12:56:29.000Z","updated_at":"2024-11-13T09:18:03.000Z","dependencies_parsed_at":"2024-02-21T10:58:40.751Z","dependency_job_id":null,"html_url":"https://github.com/Cyber-Guy1/Subdomainer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyber-Guy1%2FSubdomainer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyber-Guy1%2FSubdomainer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyber-Guy1%2FSubdomainer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyber-Guy1%2FSubdomainer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cyber-Guy1","download_url":"https://codeload.github.com/Cyber-Guy1/Subdomainer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225791533,"owners_count":17524803,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T17:04:19.823Z","updated_at":"2024-11-21T19:31:08.281Z","avatar_url":"https://github.com/Cyber-Guy1.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Subdomainer [Deprectated]\n\n\nAn automation tool for domains \u0026 subdomains gathering.\n(This tool reached its end of life right now)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"subdomainer.png\" width=\"80%\" height=\"80%\"\u003e\n  \u003cbr\u003e\u003csmall\u003eVery effective for bug hunting\u003c/small\u003e\n  \u003c/div\u003e\n\n# What is Subdomainer ?\n\nSubdomainer is an automation tool for domains \u0026 subdomains gatherin wheather for single target or multiple targets. Subdomainer uses multiple tools for doing the subdomains \u0026 domians gathering job in a perfect way, it can take a domains / targets list and doing the whole operation on them and after finshing the job it save the result in a comprehandable \u0026 ordered way.\n\nAfter the subdomainer finishes gathering subdomains \u0026 domains it filters them from the repeated subdomains \u0026 domains then filters the only live subdomains. It also use multiple methods to gather subdomains like: gathering subdomains through github searching [requires github token] also from enumerating wordlist based and other effective techniques.\n\nThis tool made \u0026 developed to work in Debian based Linux systems \u0026 have been tested on:\n\n- Kali Linux\n\nAnd it should work in other security distributions like:\n\n- ParrotOS\n- BackBox\n\n# Tool Mechanism:\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"Subdomainer - mindmap.png\"\u003e\n  \u003c/div\u003e\n\n## Subdomains \u0026 Domains Gathering:\n\n- Sublist3r\n\n- Amass\n  - Enum\n    - Passive Mode\n  - Intel\n    - Whois Mode\n\n- Github-Search\n  - Gathering Subdomains Through Github Searching\n\n- Knockpy\n  - Deep mode\n    - Gather much domains \u0026 subdomains through DNS, HTTP \u0026 HTTPS requests \n  - Fast mode\n    - Gather much domains \u0026 subdomains through DNS requests only\n\n- subfinder\n\n- gobuster\n  - enumerating subdomains through wordlist\n\n## Filtering Results:\n\n- Unuique result filtering.\n- Unique \u0026 live result filtering:\n  - httpx\n\n# Installation:\n\n1- Simply change the installation script permession to executable mode then run it:\n\n```\nchmod +x install.sh \u0026\u0026 ./install.sh\n```\n\u003csmall\u003e\u003cb\u003eNOTE:\u003c/b\u003e If you face any problems while installing please read the `install` script source code,\u003cbr\u003e i've attached further installtion instructions in the `install` script source \u003cb\u003efor those who face problems while installing\u003c/b\u003e\u003c/small\u003e\n# Usage:\n\n`-t`: This option is to set the target which [single domains] to gather it's subdomains\n\n`-l`: This option is to specify a domains list to gather their subdomains [in the list every domain in a single line] such as:\n\n```\nexample.com\ndomains.com\ntarget.com\n```\n\n`-d` This option refers to the deep mode in knockpy tool, so to activate the deep scanning mode just use it like `-d true`\n\n`-f` This option refers to the fast mode in knockpy ttol, so to activate the fast scanning mode just use it like `-f true`\n\n`-w` This option is to set a wordlist for the gobuster tool, just use it like `-w \u003cwordlist_path\u003e`\n\n`-g` This option is to set a github token for github subdomain gathering mode, use it like `-g \u003cgithub_token\u003e`\n\n `-i` This option is to ignore directory splitting while scanning a whole list, for example if the list consists of:\n \n ```\nexample.com\ndomains.com\ntarget.com\n```\n\nIf you do not add the `-i` option, the tool will make each target result in a single directory like:\n\n```\nexample.com/\n\ndomains.com/\n\ntarget.com/\n```\n\nBut if you add the `-i` option, all the result will be saved in a single directory like:\n\n`result/`\n\n \n`-h` To display the help menue of the tool\n\n# Output Example:\n\n```\n  _________    ___.        .___                    .__                     \n /   _____/__ _\\_ |__    __| _/____   _____ _____  |__| ____   ___________ \n \\_____  \\|  |  \\ __ \\  / __ |/  _ \\ /     \\\\__  \\ |  |/    \\_/ __ \\_  __ \\\n /        \\  |  / \\_\\ \\/ /_/ (  \u003c_\u003e )  Y Y  \\/ __ \\|  |   |  \\  ___/|  | \\/\n/_______  /____/|___  /\\____ |\\____/|__|_|  (____  /__|___|  /\\___  \u003e__|   \n        \\/          \\/      \\/            \\/     \\/        \\/     \\/       \n\n\t\t   🗲  Automated Subdomain Gathering Tool 🗲\n\t\t\t  Developed By Momen Ali\n\t\t\t      The Cyber Guy\n\n\n\n[usage]:\n\n-h ==\u003e Help Menue\n-t ==\u003e Target Domain\n-l ==\u003e Domains List\n-w ==\u003e Wordlist\n-d ==\u003e Knockpy Deep Mode\n-f ==\u003e Knockpy Fast Mode\n-g ==\u003e Github Token\n-i ==\u003e Ignore Directory Splitting\n\n\n[Explaination]:\n\n[+] -h : It Show The Help Menue For You Such As: Syntax, Examples, Switches\n[+] -t : To Use A Single Target Domain To Gather Subdomains On It { Put The Domain Without http Or https }\n[+] -l : To Use A Multible Domains Listed In Text File {  Put Every Domain In A Single Line Without http Or https }\n[+] -w : To Use A Wordlist For The Tools That Support Enumeration List Based { Optionally }\n[+] -d : To Use Knockpy In Deep Mode | Switch Usage -\u003e -d true or -d True\n[+] -f : To Use Knockpy In Fast Mode | Switch Usage -\u003e -f true or -f True\n[+] -g : Set Github Token For Gathering Subdomains From Github { Optionally }\n[+] -i : Ignore directory splitting for every domain in list { Only effective while using a list } | Switch usage -\u003e -i true or -i True\n\n\n[Exampels]:\n\n=================================================\n               Single Domains Based\n=================================================\n\n./subdomainer -t domain.com -f true -g 55aa66bb4aa8mm9mmss334422-weqas -w /usr/share/wordlist/dirbuster/directories.jbrofuzz\n\n./subdomainer -t domains.com -d true -g 55aa66bb4aa8mm9mmss334422-weqas -w /usr/share/wordlist/dirbuster/directories.jbrofuzz\n\n\n=================================================\n               Domains List Based\n=================================================\n\n./subdomainer -l domains.txt -d true -g 55aa66bb4aa8mm9mmss334422-weqas -w /usr/share/wordlist/dirbuster/directories.jbrofuzz -i\n\n./subdomainer -l domains.txt -f true -g 55aa66bb4aa8mm9mmss334422-weqas -w /usr/share/wordlist/dirbuster/directories.jbrofuzz\n\n\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCyber-Guy1%2FSubdomainer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCyber-Guy1%2FSubdomainer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCyber-Guy1%2FSubdomainer/lists"}