Admin Finder

Python script for checking common admin/login paths on websites you own or have explicit permission to test.

Developed by JOJIN JOHN.

Features

• Works with Python 3
• No third-party packages required
• Includes 1,000 unique admin/login paths
• Live scan progress
• Parallel scanning with configurable workers
• Supports custom wordlists
• Works on Windows, Linux, macOS, and Termux

Requirements

• Python 3.8 or newer
• Git

Clone The Repository

git clone https://github.com/jojin1709/Admin-Finder.git
cd Admin-Finder

Run On Kali, Linux, macOS, Or Termux

No install step is needed. Do not run pip install; this tool uses only Python's standard library.

python3 adm-finder.py https://example.com

Interactive mode:

python3 adm-finder.py

Run On Windows

Using the Windows launcher:

run.bat https://example.com

Using Python directly:

python adm-finder.py https://example.com

Interactive mode:

python adm-finder.py

Quick Start

git clone https://github.com/jojin1709/Admin-Finder.git
cd Admin-Finder
python3 adm-finder.py https://example.com

Examples

Show only possible admin/login pages:

python3 adm-finder.py https://example.com

Show every checked response:

python3 adm-finder.py https://example.com --show-all

Use a slower scan:

python3 adm-finder.py https://example.com --delay 0.2

Use more or fewer parallel workers:

python3 adm-finder.py https://example.com --workers 12
python3 adm-finder.py https://example.com --workers 1

Use a longer request timeout:

python3 adm-finder.py https://example.com --timeout 10

Use a custom wordlist:

python3 adm-finder.py https://example.com --wordlist wordlist.txt

Disable colors:

python3 adm-finder.py https://example.com --no-color

Options

usage: adm-finder.py [-h] [-w WORDLIST] [-t TIMEOUT] [-c WORKERS] [-d DELAY]
                     [--show-all] [--no-color]
                     [url]

• url - target URL, for example https://example.com
• -w, --wordlist - path to a custom wordlist
• -t, --timeout - request timeout in seconds
• -c, --workers - number of parallel requests
• -d, --delay - delay between requests in seconds
• --show-all - print non-matching responses too
• --no-color - disable ANSI colors

Update The Tool

If you already cloned the repository, update it with:

git pull origin main

Files

• adm-finder.py - scanner script
• wordlist.txt - common admin/login paths used by the scanner
• run.bat - Windows launcher
• LICENSE - MIT license file
• .gitignore - generated/cache files Git should ignore
• README.md - setup and usage instructions

Troubleshooting

If python does not work on Linux, macOS, or Termux, use:

python3 adm-finder.py https://example.com

If Kali shows externally-managed-environment after running pip install, you can ignore it. This project does not need pip or any external Python packages.

If Git is not installed, download it from:

https://git-scm.com/downloads

If the scan is too fast for a target you own, add a delay:

python3 adm-finder.py https://example.com --delay 0.5

If the scan looks quiet, it is still working. By default it shows live progress and only prints found paths. Use --show-all to print every checked response.

License

This project is released under the MIT License. See LICENSE for details.