{"id":34196274,"url":"https://github.com/literallyethical/r3conwhal3","last_synced_at":"2025-12-15T17:06:57.423Z","repository":{"id":219621569,"uuid":"749485405","full_name":"LiterallyEthical/r3conwhal3","owner":"LiterallyEthical","description":"r3conwhale aims to develop a multifunctional recon chain for web applications, intelligently interpreting collected data, and optimizing performance and resource consumption through a concurrency-based approach.","archived":false,"fork":false,"pushed_at":"2024-06-04T10:55:55.000Z","size":3006,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-06-21T17:05:07.560Z","etag":null,"topics":["automation-framework","bug-bounty-tools","bugbounty","dns","fuzzing","osint","pentest","pentest-tool","recon","reconnaissance","scanner","security","security-tools","subdomain-enumeration","subdomain-scanner"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LiterallyEthical.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,"publiccode":null,"codemeta":null}},"created_at":"2024-01-28T18:06:24.000Z","updated_at":"2024-06-15T21:55:25.000Z","dependencies_parsed_at":"2024-01-28T19:28:25.619Z","dependency_job_id":"ab929384-8606-42ef-bf96-aaa75df7887f","html_url":"https://github.com/LiterallyEthical/r3conwhal3","commit_stats":null,"previous_names":["literallyethical/r3conwhal3"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/LiterallyEthical/r3conwhal3","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiterallyEthical%2Fr3conwhal3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiterallyEthical%2Fr3conwhal3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiterallyEthical%2Fr3conwhal3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiterallyEthical%2Fr3conwhal3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LiterallyEthical","download_url":"https://codeload.github.com/LiterallyEthical/r3conwhal3/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiterallyEthical%2Fr3conwhal3/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27754424,"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","status":"online","status_checked_at":"2025-12-15T02:00:09.782Z","response_time":96,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["automation-framework","bug-bounty-tools","bugbounty","dns","fuzzing","osint","pentest","pentest-tool","recon","reconnaissance","scanner","security","security-tools","subdomain-enumeration","subdomain-scanner"],"created_at":"2025-12-15T17:06:52.017Z","updated_at":"2025-12-15T17:06:57.414Z","avatar_url":"https://github.com/LiterallyEthical.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003er3conwhal3\u003c/h1\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/images/r3conwhal3.png\" alt=\"r3conwhal3 Logo\" class=\"img-circle\" width=200 height=200\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e •\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#disclaimer\"\u003eDisclaimer\u003c/a\u003e •\n\u003c/p\u003e\n\n`r3conwhale` aims to develop a multifunctional recon chain for web applications, intelligently interpreting collected data, and optimizing performance and resource consumption through a concurrency-based approach.\n\n## 💿 Installation\n\n### UNIX/WSL\n\n- `r3conwhal3` requires go \u003e= 1.21.1+ to install and paths correctly set ($GOPATH, $GOROOT).\n\nRun the following command to get the repo:\n\n```\ngo install -v github.com/LiterallyEthical/r3conwhal3/cmd/r3conwhal3@latest\n```\n\nRun the following command to install dependencies\n\n```\nwget \"https://raw.githubusercontent.com/LiterallyEthical/r3conwhal3/main/installer.sh\"\nchmod +x installer.sh\n./installer.sh\n```\n\nOR\n\n```\ngit clone https://github.com/LiterallyEthical/r3conwhal3\ncd r3conwhal3/\nchmod +x installer.sh\n./installer.sh\n```\n\n### Docker Image 🐳\n\n- Pull the image\n\n```\ndocker pull literallyethical/r3conwhal3\n```\n\n- Run the container\n\n```\ndocker run -it -v \u003c/path/to/folder\u003e:/app/results -p 8080:8080 --rm literallyethical/r3conwhal3 run -d \u003ctarget-domain\u003e  -o /app/results\n```\n\n- Specify the **OutputFolder** to saving results for later and choose a **target domain** to enumerate. For detail information, please refer to the [Docker](https://hub.docker.com/r/literallyethical/r3conwhal3) documentation.\n\n\u003cdiv align=\"center\"\u003e\n  \n| :exclamation:  **Disclaimer**  |\n|:-------------------:|\n| **This project is in active development**. Expect breaking changes with releases. |\n\n\u003c/div\u003e\n\n## ⚙️ Config file\n\n- Download and configure CFG file\n\n```\nwget https://raw.githubusercontent.com/LiterallyEthical/r3conwhal3/main/cmd/r3conwhal3/docs/config.env\n```\n\n- The **config.env** file enables control over the entire execution of the automation chain.\n- You can find the default configuration file on [here](https://github.com/LiterallyEthical/r3conwhal3/blob/main/cmd/r3conwhal3/docs/config.env).\n- It is possible to set various scanning modes, tool options, personalized wordlists etc. You can find the detailed config options on [wiki](https://github.com/LiterallyEthical/r3conwhal3/wiki/0x02%E2%80%90Configuration-File).\n\n## Usage\n\n```\nr3conwhal3 [run] [galery] options\n```\n\n### Options\n\n| subcommand   | Flag             | Description                                                       |\n| :----------- | :--------------- | :---------------------------------------------------------------- |\n| run          | -A, --all        | Perform all passive \u0026 active recon process                        |\n| run          | -a, --active     | Perform active recon process (DNS bruteforce \u0026 DNS permutation)   |\n| run          | -c, --config-dir | Path to directory which config.env exists (default \"embedded\")    |\n| run          | -d, --domain     | Target domain to enumerate                                        |\n| run          | -o, --out-dir    | Directory to keep all output (default \"$HOME/r3conwhal3/results\") |\n| run          | -p, --passive    | Perform passive subdomain enumeration process                     |\n| run          | -w, --webops     | Perform web operations                                            |\n| run          | -v, --vulnscan   | Perform vulnerability scanning                                    |\n| galery       | -p, --path       | Path to screenshots directory                                     |\n| run \u0026 galery | -h, --help       | Show help menu                                                    |\n\n\u003cdiv align=\"center\"\u003e\n\n|                                                   :exclamation: **Disclaimer**                                                    |\n| :-------------------------------------------------------------------------------------------------------------------------------: |\n| See the [**wiki**](https://github.com/LiterallyEthical/r3conwhal3/wiki) for running the **r3conwhal3** with custom configuration. |\n\n\u003c/div\u003e\n\n### Example Usage\n\n#### Running the scan with default options\n\n```\nr3conwhal3 run -d \u003cdomain-name\u003e\n```\n\n#### Running the scan with custom options\n\n```\nr3conwhal3 run  -d \u003cdomain\u003e [-c \u003cpath-to-config-dir\u003e] [-outDir \u003cpath-to-out-dir\u003e]\n```\n\n\u003cdiv align=\"center\"\u003e\n\n|                                                             :exclamation: **Disclaimer**                                                              |\n| :---------------------------------------------------------------------------------------------------------------------------------------------------: |\n| It is possible to see more running examples for **r3conwhal3** on [**wiki**](https://github.com/LiterallyEthical/r3conwhal3/wiki/0x01%E2%80%90Usage). |\n\n\u003c/div\u003e\n\n## Features\n\n### \u003cdiv style=\"position: relative; display: flex; align-items: flex-end;\"\u003e\u003cimg src=\"assets/images/inspector_gadget.ico\" alt=\"Your Icon\" width=\"60\" height=\"60\"\u003e Passive Subdomain Enumeration\n\n| ID  | Tool                                                                      | Role                                                  |\n| :-: | :------------------------------------------------------------------------ | :---------------------------------------------------- |\n|  1  | [subfinder](https://github.com/projectdiscovery/subfinder)                | discovering subdomains                                |\n|  2  | [assetfinder](https://github.com/tomnomnom/assetfinder)                   | discovering more subdomains                           |\n|  3  | [amass](https://github.com/owasp-amass/amass)                             | discovering more subdomains                           |\n|  4  | [subkill3r](https://github.com/LiterallyEthical/r3conwhal3/pkg/subkill3r) | discovering more subdomains (still under development) |\n\n### Active Subdomain Enumeration\n\n| ID  | Tool                                           | Role                                 |\n| :-: | :--------------------------------------------- | :----------------------------------- |\n|  1  | [puredns](https://github.com/d3mondev/puredns) | subdomain resolving and bruteforcing |\n|  2  | [gotator](https://github.com/Josue87/gotator)  | DNS permutations                     |\n\n### Web Operations\n\n| ID  | Tool                                                           | Role                                                |\n| :-: | :------------------------------------------------------------- | :-------------------------------------------------- |\n|  1  | [httpx](https://github.com/projectdiscovery/httpx/tree/v1.3.7) | filtering live domains from the gathered subdomains |\n|  2  | [gowitness](https://github.com/sensepost/gowitness)            | taking screenshots of filtered live domains         |\n|  3  | [ffuf](https://github.com/ffuf/ffuf)                           | directory discovery \u0026 fuzzing                       |\n\n### Vulnerability Scanning\n\n| ID  | Tool                                         | Role                                     |\n| :-: | :------------------------------------------- | :--------------------------------------- |\n|  1  | [subzy](https://github.com/PentestPad/subzy) | subdomain takeover vulnerability checker |\n\n## Disclaimer\n\nUsage of this program for attacking targets without consent is illegal. It is the user's responsibility to obey all applicable laws. The developer assumes no liability and is not responsible for any misuse or damage caused by this program. Please use responsibly.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliterallyethical%2Fr3conwhal3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliterallyethical%2Fr3conwhal3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliterallyethical%2Fr3conwhal3/lists"}