## Overview
OKadminFinder is a powerful, open-source tool designed to help administrators and penetration testers discover admin panels, directories, and subdomains of a website.\
Built with Python 3.x, OKadminFinder offers a robust set of features to ensure effective and secure scanning.
## Features
- [x] Multi-Platform Support: Works on Windows, Linux, and macOS.
- [x] Easy Installation and Updates: Simple commands to install, update, and remove the tool.
- [x] Extensive Admin Panel Database: Over 1600 potential admin panels.
- [x] Command-Line Interface: Works with parameters for flexible usage.
- [x] Target URL: Specify the target URL for scanning.
- [x] URLs File: Specify a file containing a list of URLs to scan.
- [x] Random User Agents: Helps avoid detection by using random user agents.
- [x] Proxy Support: Supports HTTP/HTTPS proxies.
- [x] Socks4/5 & Tor: Enhanced anonymity with Socks4/5 and Tor support.
- [x] Custom Wordlists: Use your own wordlists for more targeted scanning.
- [x] DNS Mode: Use DNS mode for wordlist scanning.
- [x] Subdomain Discovery: Equivalent to fuzz.URL for finding subdomains.
- [x] Fuzzing Mode: Use fuzzing mode for more dynamic URL testing.
- [x] File Extensions: Search for specific file extensions.
- [x] Status Codes: Specify valid HTTP status codes or ranges.
- [x] Custom Cookies: Set custom cookies for requests.
- [x] Support for Authentication: Use custom username and password for secure access during scans.
- [x] Output File: Save results to an output file.
- [x] Cache Management: Clear and disable the cache for fresh scans.
- [x] Timeout Settings: Customize timeout settings for requests.
- [x] Connection Pools: Adjust the number of connection pools for better performance.
- [x] Threading: Control the number of threads for concurrent processing.
- [x] Retry Mechanism: Set the number of retries for failed requests.
- [x] Delay Customization: Fine-tune delay between requests to control response times.
- [x] Debug Mode: Detailed logging for debugging purposes.
* ## Requirements
* #### Linux
```bash
❯ sudo apt install tor
❯ sudo service tor start
```
* #### Windows
Download [tor windows expert bundle](https://www.torproject.org/download/tor/)
* ## Installation
* #### PyPi
```bash
# Install
❯ pip install okadminfinder
# Update
❯ pip install --upgrade okadminfinder
# Remove
❯ pip uninstall okadminfinder
```
* #### Git Clone
```bash
# Download and Usage
❯ git clone https://github.com/mIcHyAmRaNe/okadminfinder.git
❯ cd okadminfinder
❯ pip3 install -r requirements.txt
❯ chmod +x okadminfinder.py
❯ ./okadminfinder.py -h
```
## Preview
<div style="width: 100%; max-width: 600px; margin: 0 0 0 55px; background: var(--color-canvas-default, #ffffff); border: 1px solid var(--color-border-default, #ddd); border-radius: 10px; box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); overflow: hidden;">
<a href="https://youtu.be/vU5R9OoMqFc?si=Rees4MV9FfL9xgf9" target="_blank">
<img src="https://i.imgur.com/KdlHadA.png" alt="Watch the video" style="width: 100%; display: block;" />
</a>
</div>
## Usage
* ### Basic Usage
```bash
# Scanning a Single URL
❯ okadminfinder --url https://example.com
# Scanning Multiple URLs from a File
❯ okadminfinder --urls-file urls.txt
# Using a Custom Wordlist
❯ okadminfinder --url https://example.com --wordlist custom_wordlist.txt
# Using Random User Agents
❯ okadminfinder --url https://example.com --random-agent
# Using a Proxy
❯ okadminfinder --url https://example.com --proxy 127.0.0.1:8080
# Using Tor for Anonymity
❯ okadminfinder --url https://example.com --tor
```
> [!IMPORTANT]
> Parameter Conflicts:\
> Proxy and Tor: You cannot use both a proxy and Tor at the same time.\
> DNS Mode and Fuzzing Mode: You cannot use both DNS mode and fuzzing mode at the same time.\
> Files Option and Non-Fuzzing Mode: The --files option can only be used with the fuzzing mode.\
> URL and URLs File: You cannot provide both a single URL and a file containing multiple URLs at the same time.
* ### Advanced Usage
For more advanced usage examples and detailed documentation, an Advanced Wiki is under construction.
## Developer Section
* #### PyPi
```bash
# Install Poetry
curl -sSL https://install.python-poetry.org | python3 -
# Clone the repo
git clone https://github.com/mIcHyAmRaNe/okadminfinder.git
# Build the project
poetry build
# Publish the package
poetry publish
```
* #### Debian (planned)
```bash
# Install Poetry
curl -sSL https://install.python-poetry.org | python3 -
# Install build requirements
sudo apt install debhelper dh-python python3-setuptools python3-all pybuild-plugin-pyproject
# Clone the repo
git clone https://github.com/mIcHyAmRaNe/okadminfinder.git
# Create the source tarball
tar czf okadminfinder_{version}.orig.tar.gz okadminfinder
# Get inside the project folder
cd okadminfinder
# Build the deb package
dpkg-buildpackage -rfakeroot -uc -us
# Notes:
# Steps from Python to Debian.
# Install Stdeb
pip install stdeb
# Debianize Python package creating debian folder
python3 setup.py --command-packages=stdeb.command debianize
# we edit rules, control files, we create changelog, man pages...
# Build deb package
dpkg-buildpackage -rfakeroot -uc -us
# before building a new version, make sure to clean it first
```
## YouTube Videos
- [OKadminFinder 2.0: Take Control of Your Admin Panel Discovery!](https://youtu.be/vU5R9OoMqFc?si=oXCJv77PbZwL4IEI)
## Disclaimer
> [!IMPORTANT]
> OKadminFinder is intended for educational purposes and authorized penetration testing only.
> Usage of OKadminFinder for attacking targets without prior mutual consent is illegal. It is the end user's responsibility to obey all applicable local, state, and federal laws. Developers assume no liability and are not responsible for any misuse or damage caused by this program.
## License
This project is licensed under the MIT License. See the LICENSE file for details.
## Donate
> [!INFO]
> If you find OKadminFinder useful and would like to support its development, you can donate to the following address:\
> **Bitcoin Address:** `1LZiNVRZupWNbB9bEPxsiwoC5AGPAuFCjp` \
> Your support is greatly appreciated ♥️
Raw data
{
"_id": null,
"home_page": "https://github.com/mIcHyAmRaNe/okadminfinder",
"name": "okadminfinder",
"maintainer": "mIcHyAmRaNe",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "6m63er17c@mozmail.com",
"keywords": "admin panel, admin, panel, finder, directory, fuzz, subdomain, security, pentest, okadminfinder, web",
"author": "mIcHyAmRaNe",
"author_email": "6m63er17c@mozmail.com",
"download_url": "https://files.pythonhosted.org/packages/ae/02/7f523c04129415a02a05f56f70ef8ec7f2ea86d6c84564766200440f1abb/okadminfinder-2.0.0.tar.gz",
"platform": null,
"description": "\n\n\n\n\n\n\n## Overview\n\nOKadminFinder is a powerful, open-source tool designed to help administrators and penetration testers discover admin panels, directories, and subdomains of a website.\\\nBuilt with Python 3.x, OKadminFinder offers a robust set of features to ensure effective and secure scanning.\n\n## Features\n\n - [x] Multi-Platform Support: Works on Windows, Linux, and macOS.\n - [x] Easy Installation and Updates: Simple commands to install, update, and remove the tool.\n - [x] Extensive Admin Panel Database: Over 1600 potential admin panels.\n - [x] Command-Line Interface: Works with parameters for flexible usage.\n - [x] Target URL: Specify the target URL for scanning.\n - [x] URLs File: Specify a file containing a list of URLs to scan.\n - [x] Random User Agents: Helps avoid detection by using random user agents.\n - [x] Proxy Support: Supports HTTP/HTTPS proxies.\n - [x] Socks4/5 & Tor: Enhanced anonymity with Socks4/5 and Tor support.\n - [x] Custom Wordlists: Use your own wordlists for more targeted scanning.\n - [x] DNS Mode: Use DNS mode for wordlist scanning.\n - [x] Subdomain Discovery: Equivalent to fuzz.URL for finding subdomains.\n - [x] Fuzzing Mode: Use fuzzing mode for more dynamic URL testing.\n - [x] File Extensions: Search for specific file extensions.\n - [x] Status Codes: Specify valid HTTP status codes or ranges.\n - [x] Custom Cookies: Set custom cookies for requests.\n - [x] Support for Authentication: Use custom username and password for secure access during scans.\n - [x] Output File: Save results to an output file.\n - [x] Cache Management: Clear and disable the cache for fresh scans.\n - [x] Timeout Settings: Customize timeout settings for requests.\n - [x] Connection Pools: Adjust the number of connection pools for better performance.\n - [x] Threading: Control the number of threads for concurrent processing.\n - [x] Retry Mechanism: Set the number of retries for failed requests.\n - [x] Delay Customization: Fine-tune delay between requests to control response times.\n - [x] Debug Mode: Detailed logging for debugging purposes.\n\n* ## Requirements\n\n\n\n\n\n * #### Linux\n\n ```bash\n \u276f sudo apt install tor\n \u276f sudo service tor start\n ```\n\n * #### Windows\n\n Download [tor windows expert bundle](https://www.torproject.org/download/tor/)\n\n* ## Installation\n\n * #### PyPi\n\n ```bash\n # Install\n \u276f pip install okadminfinder\n # Update\n \u276f pip install --upgrade okadminfinder\n # Remove\n \u276f pip uninstall okadminfinder\n ```\n\n * #### Git Clone\n \n ```bash\n # Download and Usage\n \u276f git clone https://github.com/mIcHyAmRaNe/okadminfinder.git\n \u276f cd okadminfinder\n \u276f pip3 install -r requirements.txt\n \u276f chmod +x okadminfinder.py\n \u276f ./okadminfinder.py -h\n ```\n\n## Preview\n\n<div style=\"width: 100%; max-width: 600px; margin: 0 0 0 55px; background: var(--color-canvas-default, #ffffff); border: 1px solid var(--color-border-default, #ddd); border-radius: 10px; box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); overflow: hidden;\">\n <a href=\"https://youtu.be/vU5R9OoMqFc?si=Rees4MV9FfL9xgf9\" target=\"_blank\">\n <img src=\"https://i.imgur.com/KdlHadA.png\" alt=\"Watch the video\" style=\"width: 100%; display: block;\" />\n </a>\n</div>\n\n\n## Usage\n\n * ### Basic Usage\n\n ```bash\n # Scanning a Single URL\n \u276f okadminfinder --url https://example.com\n \n # Scanning Multiple URLs from a File\n \u276f okadminfinder --urls-file urls.txt\n \n # Using a Custom Wordlist\n \u276f okadminfinder --url https://example.com --wordlist custom_wordlist.txt\n \n # Using Random User Agents\n \u276f okadminfinder --url https://example.com --random-agent\n \n # Using a Proxy\n \u276f okadminfinder --url https://example.com --proxy 127.0.0.1:8080\n \n # Using Tor for Anonymity\n \u276f okadminfinder --url https://example.com --tor\n ```\n\n > [!IMPORTANT]\n > Parameter Conflicts:\\\n > Proxy and Tor: You cannot use both a proxy and Tor at the same time.\\\n > DNS Mode and Fuzzing Mode: You cannot use both DNS mode and fuzzing mode at the same time.\\\n > Files Option and Non-Fuzzing Mode: The --files option can only be used with the fuzzing mode.\\\n > URL and URLs File: You cannot provide both a single URL and a file containing multiple URLs at the same time.\n\n * ### Advanced Usage\n\n For more advanced usage examples and detailed documentation, an Advanced Wiki is under construction.\n\n## Developer Section\n\n * #### PyPi\n\n ```bash\n # Install Poetry\n curl -sSL https://install.python-poetry.org | python3 -\n \n # Clone the repo\n git clone https://github.com/mIcHyAmRaNe/okadminfinder.git\n \n # Build the project\n poetry build\n \n # Publish the package\n poetry publish\n ```\n \n* #### Debian (planned)\n\n ```bash\n # Install Poetry\n curl -sSL https://install.python-poetry.org | python3 -\n \n # Install build requirements\n sudo apt install debhelper dh-python python3-setuptools python3-all pybuild-plugin-pyproject\n \n # Clone the repo\n git clone https://github.com/mIcHyAmRaNe/okadminfinder.git\n \n # Create the source tarball\n tar czf okadminfinder_{version}.orig.tar.gz okadminfinder\n \n # Get inside the project folder\n cd okadminfinder\n \n # Build the deb package\n dpkg-buildpackage -rfakeroot -uc -us\n\n # Notes:\n # Steps from Python to Debian.\n # Install Stdeb\n pip install stdeb\n # Debianize Python package creating debian folder\n python3 setup.py --command-packages=stdeb.command debianize\n # we edit rules, control files, we create changelog, man pages...\n # Build deb package\n dpkg-buildpackage -rfakeroot -uc -us\n # before building a new version, make sure to clean it first\n ```\n## YouTube Videos\n\n - [OKadminFinder 2.0: Take Control of Your Admin Panel Discovery!](https://youtu.be/vU5R9OoMqFc?si=oXCJv77PbZwL4IEI)\n\n## Disclaimer\n\n> [!IMPORTANT]\n> OKadminFinder is intended for educational purposes and authorized penetration testing only.\n> Usage of OKadminFinder for attacking targets without prior mutual consent is illegal. It is the end user's responsibility to obey all applicable local, state, and federal laws. Developers assume no liability and are not responsible for any misuse or damage caused by this program.\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n\n## Donate\n\n> [!INFO]\n> If you find OKadminFinder useful and would like to support its development, you can donate to the following address:\\\n> **Bitcoin Address:** `1LZiNVRZupWNbB9bEPxsiwoC5AGPAuFCjp` \\\n> Your support is greatly appreciated \u2665\ufe0f\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "OKadminFinder: open-source tool designed to help administrators and penetration testers discover admin panels, directories, and subdomains of a website.",
"version": "2.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/mIcHyAmRaNe/okadminfinder/issues",
"Homepage": "https://github.com/mIcHyAmRaNe/okadminfinder",
"Repository": "https://github.com/mIcHyAmRaNe/okadminfinder"
},
"split_keywords": [
"admin panel",
" admin",
" panel",
" finder",
" directory",
" fuzz",
" subdomain",
" security",
" pentest",
" okadminfinder",
" web"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c3dc1bbc4d2f36696cbb25f1046aba21d86a4cbd4567f38ab477a9cc54fada1a",
"md5": "a418a21efc649a4c2b8e919465c1a003",
"sha256": "156570942b18f55d3080e5be4db5439b0ab452680c16465034f7f362c4018b95"
},
"downloads": -1,
"filename": "okadminfinder-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a418a21efc649a4c2b8e919465c1a003",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 26586,
"upload_time": "2025-01-19T12:59:00",
"upload_time_iso_8601": "2025-01-19T12:59:00.563541Z",
"url": "https://files.pythonhosted.org/packages/c3/dc/1bbc4d2f36696cbb25f1046aba21d86a4cbd4567f38ab477a9cc54fada1a/okadminfinder-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ae027f523c04129415a02a05f56f70ef8ec7f2ea86d6c84564766200440f1abb",
"md5": "c9d750c1e4079babe80b014941deb353",
"sha256": "69c3b5bb14d771521b4307a7f632d3c1647543e6b8c52eda55b37d17deee6fe5"
},
"downloads": -1,
"filename": "okadminfinder-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "c9d750c1e4079babe80b014941deb353",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 25527,
"upload_time": "2025-01-19T12:59:02",
"upload_time_iso_8601": "2025-01-19T12:59:02.379616Z",
"url": "https://files.pythonhosted.org/packages/ae/02/7f523c04129415a02a05f56f70ef8ec7f2ea86d6c84564766200440f1abb/okadminfinder-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-19 12:59:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mIcHyAmRaNe",
"github_project": "okadminfinder",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "okadminfinder"
}
JSON
