{"id":19745534,"url":"https://github.com/s-r-e-e-r-a-j/DirectoryBuster","last_synced_at":"2025-04-30T07:34:27.423Z","repository":{"id":261671090,"uuid":"884996313","full_name":"s-r-e-e-r-a-j/DirectoryBuster","owner":"s-r-e-e-r-a-j","description":"DirectoryBuster is a GUI-based directory brute-forcing tool designed to help penetration testers and security researchers discover hidden directories and files on web servers ","archived":false,"fork":false,"pushed_at":"2025-04-20T18:42:54.000Z","size":153,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-20T19:37:22.556Z","etag":null,"topics":["directorybruteforce","directorybuster","ethical-hacking","ethical-hacking-tools","hacking-tool","hacking-tools","hackingtools","kali-linux-hacking","kali-linux-tools","python","python-3","python3","pythontool","pythontools"],"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/s-r-e-e-r-a-j.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null}},"created_at":"2024-11-07T19:03:54.000Z","updated_at":"2025-04-20T18:42:57.000Z","dependencies_parsed_at":"2024-11-07T20:20:57.042Z","dependency_job_id":"db7a2685-63ee-4d2c-a72f-31bcaa4250b4","html_url":"https://github.com/s-r-e-e-r-a-j/DirectoryBuster","commit_stats":null,"previous_names":["s-r-e-e-r-a-j/directorybuster-tool"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-r-e-e-r-a-j%2FDirectoryBuster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-r-e-e-r-a-j%2FDirectoryBuster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-r-e-e-r-a-j%2FDirectoryBuster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-r-e-e-r-a-j%2FDirectoryBuster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/s-r-e-e-r-a-j","download_url":"https://codeload.github.com/s-r-e-e-r-a-j/DirectoryBuster/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251661096,"owners_count":21623379,"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":["directorybruteforce","directorybuster","ethical-hacking","ethical-hacking-tools","hacking-tool","hacking-tools","hackingtools","kali-linux-hacking","kali-linux-tools","python","python-3","python3","pythontool","pythontools"],"created_at":"2024-11-12T02:09:22.567Z","updated_at":"2025-04-30T07:34:27.417Z","avatar_url":"https://github.com/s-r-e-e-r-a-j.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## DirectoryBuster\nDirectoryBuster is a GUI-based directory brute-forcing tool designed to help penetration testers and security researchers discover hidden directories and files on web servers. By testing a target URL against a wordlist of potential directory and file names, it identifies accessible resources that may pose security risks.\n\n---\n\n## Features  \n\n- **Easy-to-Use Interface**:  Simple and user-friendly GUI.  \n- **Custom Wordlist**:\n  Choose your own wordlist for scanning.  \n- **Supports File Extensions**: Check for files with extensions like `.php, .html, .js`.  \n-  **Save Results**: Option to save founded results to a file.  \n-  **Clickable Links**: Open found URLs directly in a browser.  \n-  **Live Updates**:See the scanning progress in real-time.  \n-  **Fast Scanning**:Uses multi-threading for better performance.  \n-  **Start \u0026 Stop Anytime**: Control the scan with start and stop buttons.  \n-  **Error Handling**:Handles network issues without crashing.\n  \n---\n\n## Requirements\n- Python 3.x\n- requests (for sending HTTP requests)\n- tkinter (for the GUI)\n- threading\n- webbrowser\n  \n## Installation\n\n\n1. **Clone the repository to your local machine**\n```bash\ngit clone https://github.com/s-r-e-e-r-a-j/DirectoryBuster.git\n```\n2. **Navigate to the DirectoryBuster directory**\n```bash\ncd DirectoryBuster\n```\n\n3. **Install the required dependencies:**\n\n```bash\npip3 install -r requirements.txt\n```\n\n4. **Navigate to the DIRECTORYBUSTER directory**\n  ```bash\ncd DIRECTORYBUSTER\n```\n5. **Install the tool**\n  ```bash\nsudo python3 install.py\n```\nThen enter `y` for install\n\n6. **Run the Tool:**\n```bash\ndirectorybuster\n```\n\n## How to Use  \n\n1. **Enter Target URL**  \n   - Example: `https://example.com`\n\n2. **Select a Wordlist**  \n   - Click the **\"Browse\"** button and choose a `.txt` file containing directory names\n\n3. **(Optional) Add File Extensions**  \n   - Example: `.php,.html,.js` (comma-separated).\n\n4. **(Optional) Enable Save Results**  \n   - Check the **\"Save found results\"** box and select a file to save the output.\n\n5. **Start Scanning**  \n   - Click the **\"Start\"** button to begin the scan.  \n   - The Tool will  Test each word in the wordlist **without extensions**.\n   - The Tool will Test each word in the wordlist **with each extension** (if added).\n   - Show the results in real-time.\n\n6. **Open Found Links**  \n   - Click on any found URL to open it in your default browser.\n\n7. **Stop Scanning**  \n   - Click the **\"Stop\"** button to cancel the scan at any time.\n     \n\n  \n## Example Usage\n\n1. **Enter the Target URL**:  \n   Type the website URL you want to scan, for example: `https://example.com`.\n\n2. **Choose a Wordlist File**:  \n   Click the \"Browse\" button and select a wordlist file (e.g., `common-directories.txt`).\n\n3. **Add Extensions (Optional)**:  \n   If you want to test specific file types, type the extensions separated by commas (e.g., `.js,.php,.html`).\n\n4. **Save Results (Optional)**:  \n   Check the \"Save found results\" box and click \"Select Save File\" to choose where to save the results.\n\n5. **Start Scanning**:  \n   Click the \"Start\" button. The tool will:\n   - Test each word in the wordlist **without extensions**.\n   - Test each word in the wordlist **with each extension** (if added).\n   - Show the results in real-time.\n\n6. **View Found Results**:  \n   Founded results will appear in the \"Found Results\" section. Click on any URL to open it in your browser.\n\n7. **Stop Scanning**:  \n   Click the \"Stop\" button anytime to stop the scanning process.\n   \n## Picture\n\n\n![VirtualBox_klinux13_02_03_2025_12_56_00](https://github.com/user-attachments/assets/ffc21e2f-876e-4b05-9378-507cd19445a3)\n\n\n\n## uninstallation\n\n```bash\ncd DirectoryBuster\n```\n```bash\ncd DIRECTORYBUSTER\n```\n```bash\nsudo python3 install.py\n```\nThen Enter `n` for uninstall\n\n\n## Troubleshooting\n\n- **Error: No wordlist selected**\nEnsure that you have selected a valid wordlist file by clicking the \"Browse\" button.\n\n- **Error: No target URL entered**\nEnter the target URL before clicking \"Start\".\n\n- **Error: Cannot save results**\nEnsure that you have selected a valid file path to save the results.\n\n## License\nThis tool is licensed under the MIT License. See LICENSE for more details.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs-r-e-e-r-a-j%2FDirectoryBuster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fs-r-e-e-r-a-j%2FDirectoryBuster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs-r-e-e-r-a-j%2FDirectoryBuster/lists"}