{"id":19206694,"url":"https://github.com/blue0x1/arescan","last_synced_at":"2025-04-10T14:10:57.339Z","repository":{"id":148510033,"uuid":"620225421","full_name":"blue0x1/Arescan","owner":"blue0x1","description":"Arescan is a powerful web directory discovery tool that helps you uncover hidden directories and links on any website. By performing a breadth-first search.","archived":false,"fork":false,"pushed_at":"2023-04-05T22:13:41.000Z","size":45,"stargazers_count":30,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-24T12:55:33.665Z","etag":null,"topics":["directory-analyzer","scanner-web","tools","webscanner"],"latest_commit_sha":null,"homepage":"","language":"Python","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/blue0x1.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":"2023-03-28T09:14:14.000Z","updated_at":"2024-11-07T06:09:00.000Z","dependencies_parsed_at":"2023-05-20T09:45:58.141Z","dependency_job_id":null,"html_url":"https://github.com/blue0x1/Arescan","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blue0x1%2FArescan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blue0x1%2FArescan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blue0x1%2FArescan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blue0x1%2FArescan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blue0x1","download_url":"https://codeload.github.com/blue0x1/Arescan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248232414,"owners_count":21069487,"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":["directory-analyzer","scanner-web","tools","webscanner"],"created_at":"2024-11-09T13:16:38.416Z","updated_at":"2025-04-10T14:10:57.329Z","avatar_url":"https://github.com/blue0x1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eArescan: Advanced Directory Discovery Tool\u003c/h1\u003e\n\nArescan is a powerful web directory discovery tool that helps you uncover hidden directories and links on any website. By performing a breadth-first search, it efficiently scans websites and collects useful information that can be utilized for web security assessment, bug bounty hunting, or simply discovering new pages.\n\n\n\n![Ares](https://e1.pxfuel.com/desktop-wallpaper/687/39/desktop-wallpaper-god-of-war-ares-backgrounds-god-of-war-monster.jpg)\n\n\n## Features\n\n- Accelerated scanning performance with multi-threading\n- Stealth capabilities with randomized user agents\n- Comprehensive link examination\n- Robust connection security\n- Advanced HTML processing with Beautiful Soup 4\n- Customizable wordlists\n- Supports pausing the search and saving progress.\n- Output to a file for easy post-processing\n- Python 3 optimization\n- Recursive directory scanning\n- Fuzzing to discover hidden files, directories, or parameters\n- Ability to specify maximum recursion depth\n- Support for file extensions search\n- Support for proxy list and rate limiting\n- Support for Tor network\n- Support for automatically select proxies\n\n## Changelog\n### v1.3 \n- Added a new option to enable automatic proxy usage\n- Added autosave\n\n### Fixes:\nFixed an issue where proxies were not being used properly.\n\n### v1.2 \n- Added support for recursive search\n- Added support for file/directory fuzzing\n- Added support for searching specific file extensions\n- Added support for using proxies\n- Added option for delay between requests\n- Added Tor support\n\n### v1.1\n\n- Added multi-threading support for faster scanning\n- Added support for custom wordlists\n- Supports the ability to pause and resume the search process.\n- Fixed a bug when using a wordlist\n\n### v1.0\n\n- Initial release\n\n## Requirements\n\n- Python 3.x\n- Beautiful Soup 4\n- Requests\n\n\n\n## Installation \u003cbr\u003e\nClone the Arescan repository:\u003cbr\u003e\n``` bash\n\ngit clone https://github.com/blue0x1/Arescan.git\n```\nChange to the Arescan directory:\u003cbr\u003e\n``` bash\n\ncd Arescan\n```\nInstall the required Python packages:\n``` bash\npip install -r requirements.txt\n```\n## Usage \u003cbr\u003e\n``` bash\npython3 Arescan.py \u003curl\u003e\n```\nReplace \u003curl\u003e with the base URL of the website you want to scan.\n\n## Example \u003cbr\u003e\n``` bash\npython3 Arescan.py https://example.com\n  ```\n## Advanced Options\n\npython3 Arescan.py \u003curl\u003e [-w \u003cwordlist\u003e] [-o \u003coutput\u003e] [-r] [-f] [-d \u003cdepth\u003e] [-e \u003cextensions\u003e] [-p \u003cproxies\u003e] [-l \u003cdelay\u003e] [-t]\n\n\n\n``` bash\n\npython3 Arescan.py http://example.com -w wordlist.txt -o output.txt -r -f -d 5 -e .php,.html -p proxies.txt -l 1 -t\n\n\n\n\u003curl\u003e: The base URL to search.\n-w \u003cwordlist\u003e (optional): Path to the wordlist file.\n-o \u003coutput\u003e (optional): Path to the output file.\n-r (optional): Enable recursive search (default: 3 levels deep).\n-f (optional): Enable fuzzing to discover hidden files, directories, or parameters.\n-d \u003cdepth\u003e (optional): Maximum recursion depth (default: 3).\n-e \u003cextensions\u003e (optional): Comma-separated list of file extensions to search (e.g., .php,.html).\n--auto-proxy (optional): Automatically use proxies\n-p \u003cproxies\u003e (optional): Path to the proxy list file (one proxy per line).\n-l \u003cdelay\u003e (optional): Delay between requests in seconds (default: 0).\n-t (optional): Enable Tor support.\n\n```\nThis will perform a recursive search on http://example.com, using the wordlist.txt wordlist file, and saving the output to output.txt. The search will be up to 5 levels deep, and will include fuzzing to discover hidden files and directories with the extensions .php and .html. The search will be rate-limited by a delay of 1 second between requests, using the proxies listed in proxies.txt. Finally, Tor support will be enabled.\n\n## Output \u003cbr\u003e\nArescan will print discovered URLs with their corresponding HTTP status codes. Once the scan is complete, it will display a list of all found URLs within the target domain. If an output file is specified, the found URLs will be saved in the file.\n\u003cbr\u003e\n\n## License \u003cbr\u003e\nArescan is released under the MIT License. See the [LICENSE](https://github.com/blue0x1/Arescan/blob/main/LICENSE) file for details.\u003cbr\u003e\n\n## Author \u003cbr\u003e \nChokri Hammedi ( blue0x1 )\n\u003cbr\u003e\n## Disclaimer\nArescan is intended for educational and legal purposes only. The author is not responsible for any misuse or damage caused by using this tool. Always obtain permission from the website owner before scanning their site.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblue0x1%2Farescan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblue0x1%2Farescan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblue0x1%2Farescan/lists"}