opendoor 5.2.0

Console web directory and subdomain scanner for security research and asset discovery

OWASP WEB Directory Scanner

Python	Linux	macOS	Windows
3.12
3.13
3.14

OpenDoor OWASP is a multifunctional console website scanner.
This application finds possible login entry points, Index of/ directories, web shells, restricted access points, subdomains, hidden data, and large backup files.
Scanning is performed using both the built-in dictionary and external dictionaries.
Anonymity and speed are provided through the use of proxy servers.
The software is written for informational purposes and is released as an open-source product under the GPL license.
The project is part of BlackArch Linux and is maintained and supported by the community.

Read The Docs

• Current 5.2.0 (20.04.2026)
  • Directories: 110977
  • Subdomains: 255359

Changelog (last changes)

v5.2.0 (20.04.2026)

• (feature) Added recursive directory scan support.
• (feature) Added configurable recursion depth via --recursive-depth.
• (feature) Added configurable HTTP status allowlist for recursive expansion via --recursive-status.
• (feature) Added configurable excluded extensions for recursive expansion via --recursive-exclude.
• (optimization) Browser request flow is now depth-aware for recursive workloads.
• (optimization) ThreadPool total items can be extended for recursive workloads.
• (docs) Updated README.md and docs/Usage.md for recursive scan support and refreshed CLI help output.
• (tests) Test suite expanded to 546 tests with recursive browser/config/thread-pool coverage.

Main features

• ✅ directories scanner
• ✅ recursive directory scanner
• ✅ subdomains scanner
• ✅ multithreading control
• ✅ HTTP(S) (PORT) support
• ✅ Keep-alive long pooling
• ✅ Invalid certificates scan
• ✅ HTTP(S)/SOCKS proxies
• ✅ dynamic request headers
  • custom cookies support
  • custom or randomized user-agent support
  • cache-control support
• ✅ custom wordlists prefixes
• ✅ custom wordlists, proxies, ignore lists
• ✅ debug levels (1-3)
• ✅ extensions filters
• ✅ custom config wizard (use random techniques)
• ✅ scans reporting
  • console reports
  • json reports
  • txt reports
  • html reports
• ✅ analyze techniques:
  • detect redirects
  • detect index of/ Apache
  • detect large files
  • skip 200 OK redirects
  • skip empty pages
  • cookie routing (reusing cookies)
  • heuristic detect invalid pages (false 404)
  • blank success page filter
  • certificate required pages
• ✅ randomization techniques:
  • random user-agent per request
  • random proxy per request
  • wordlists shuffling
  • wordlists filters

Recursive scan

Recursive scan is optional and reuses the active dictionary under discovered directory-like paths.

opendoor --host http://www.example.com --recursive
opendoor --host http://www.example.com --recursive --recursive-depth 2
opendoor --host http://www.example.com --recursive --recursive-status 200,403
opendoor --host http://www.example.com --recursive --recursive-exclude jpg,png,css,js,pdf

Behavior:

• --recursive enables recursive directory scan
• --recursive-depth limits how deep recursive expansion may continue
• --recursive-status controls which HTTP status codes are allowed to trigger recursive expansion
• --recursive-exclude prevents file-like paths from spawning nested requests

Install PIP

python3 -m ensurepip --upgrade
python3 -m pip install --upgrade pip

Global installation from PyPI

Use this if you want the package available as a normal Python CLI tool.

Linux / macOS

python3 -m pip install --upgrade opendoor
opendoor --host http://www.example.com

Windows (PowerShell)

winget install Python.Python.3.14
py -m pip install --upgrade pip
py -m pip install --upgrade opendoor

opendoor --host http://www.example.com

Global installation with pipx (recommended for end users)

macOS / Homebrew

brew install pipx
pipx ensurepath
pipx install opendoor

opendoor --host http://www.example.com

Linux / generic environments

Install pipx with your system package manager or preferred Python tooling, then:

pipx ensurepath
pipx install opendoor

opendoor --host http://www.example.com

Windows (PowerShell)

winget install Python.Python.3.14
py -m pip install --user pipx
py -m pipx ensurepath

# Reopen PowerShell after ensurepath
pipx install opendoor

opendoor --host http://www.example.com

pipx is the preferred option when you want an isolated CLI installation without managing a project virtual environment manually.

Local installation and run

Use this mode if you want to run OpenDoor directly from the repository without installing it globally.

Linux / macOS

git clone https://github.com/stanislav-web/OpenDoor.git
cd OpenDoor/
python3 -m pip install -r requirements.txt
chmod +x opendoor.py

python3 opendoor.py --host http://www.example.com

Windows (PowerShell)

git clone https://github.com/stanislav-web/OpenDoor.git
cd OpenDoor
py -m pip install -r requirements.txt

py opendoor.py --host http://www.example.com

Local development installation

Use this mode if you are developing, testing, or changing the project locally.

Linux / macOS

git clone https://github.com/stanislav-web/OpenDoor.git
cd OpenDoor/
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip setuptools wheel
python -m pip install -r requirements-dev.txt
python -m pip install -e .

opendoor --host http://www.example.com

Windows (PowerShell)

git clone https://github.com/stanislav-web/OpenDoor.git
cd OpenDoor
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip setuptools wheel
python -m pip install -r requirements-dev.txt
python -m pip install -e .

opendoor --host http://www.example.com

Installation from source for OS distributions / maintainers

This flow is intended for Linux distributions, package maintainers, and release pipelines.

Linux / macOS

git clone https://github.com/stanislav-web/OpenDoor.git
cd OpenDoor/
python3 -m pip install --upgrade build
python3 -m build

Windows (PowerShell)

git clone https://github.com/stanislav-web/OpenDoor.git
cd OpenDoor
py -m pip install --upgrade build
py -m build

Generated artifacts:

dist/opendoor-5.2.0.tar.gz
dist/opendoor-5.2.0-py3-none-any.whl

This flow is preferable for Linux distributions and package maintainers because:

• source package and wheel are generated through the standard Python build backend
• installation can be managed by the distribution package manager
• updates can be delivered together with OS package updates
• no legacy setup.py install flow is required

The package is already present in BlackArch Linux, and this build layout is intended to make packaging for other Linux distributions easier as well.

Manual installation from built wheel

Linux / macOS

python3 -m pip install dist/opendoor-5.2.0-py3-none-any.whl
opendoor --host http://www.example.com

Windows (PowerShell)

py -m pip install dist/opendoor-5.2.0-py3-none-any.whl
opendoor --host http://www.example.com

Updates

PyPI installation

Linux / macOS:

python3 -m pip install --upgrade opendoor

Windows:

py -m pip install --upgrade opendoor

pipx installation

pipx upgrade opendoor

Source checkout

Linux / macOS:

git pull
python3 -m pip install -e .

Windows:

git pull
py -m pip install -e .

Help

usage: opendoor [-h] [--host HOST] [-p PORT] [-m METHOD] [-t THREADS]
                [-d DELAY] [--timeout TIMEOUT] [-r RETRIES]
                [--keep-alive] [--accept-cookies] [--debug DEBUG] [--tor]
                [--torlist TORLIST] [--proxy PROXY] [-s SCAN] [-w WORDLIST]
                [--reports REPORTS] [--reports-dir REPORTS_DIR]
                [--random-agent] [--random-list] [--prefix PREFIX]
                [-e EXTENSIONS] [-i IGNORE_EXTENSIONS] [--recursive]
                [--recursive-depth RECURSIVE_DEPTH]
                [--recursive-status RECURSIVE_STATUS]
                [--recursive-exclude RECURSIVE_EXCLUDE] [--sniff SNIFF]
                [--update] [--version] [--examples] [--docs]
                [--wizard [WIZARD]]

options:
  -h, --help            show this help message and exit

required named options:
  --host HOST           Target host; example: --host http://example.com

Application tools:
  --update              Show package update instructions
  --version             Show current version
  --examples            Show usage examples
  --docs                Open documentation
  --wizard [WIZARD]     Run scanner wizard from your config

Debug tools:
  --debug DEBUG         Debug level -1 (silent), 1 - 3

Reports tools:
  --reports REPORTS     Scan reports (json,std,txt,html)
  --reports-dir REPORTS_DIR
                        Path to custom reports directory

Request tools:
  -p PORT, --port PORT  Custom port (default 80)
  -m METHOD, --method METHOD
                        Request method (HEAD by default)
  -d DELAY, --delay DELAY
                        Delay between threaded requests
  --timeout TIMEOUT     Request timeout (30 sec default)
  -r RETRIES, --retries RETRIES
                        Maximum reconnect retries (default 3)
  --keep-alive          Use keep-alive connection
  --accept-cookies      Accept and route cookies from responses
  --tor                 Use built-in proxy list
  --torlist TORLIST     Path to custom proxy list
  --proxy PROXY         Custom permanent proxy server
  --random-agent        Randomize user-agent per request

Sniff tools:
  --sniff SNIFF         Response sniff plugins
                        (indexof,collation,file,skipempty,skipsizes=NUM:NUM...)

Stream tools:
  -t THREADS, --threads THREADS
                        Allowed threads

Wordlist tools:
  -s SCAN, --scan SCAN  Scan type: directories or subdomains
  -w WORDLIST, --wordlist WORDLIST
                        Path to custom wordlist
  --random-list         Shuffle scan list
  --prefix PREFIX       Append path prefix to scan host
  -e EXTENSIONS, --extensions EXTENSIONS
                        Force selected extensions for scan session, e.g. php,json
  -i IGNORE_EXTENSIONS, --ignore-extensions IGNORE_EXTENSIONS
                        Ignore selected extensions for the scan session, e.g. aspx,jsp
  --recursive           Enable recursive directory scan
  --recursive-depth RECURSIVE_DEPTH
                        Maximum recursive scan depth
  --recursive-status RECURSIVE_STATUS
                        HTTP status codes allowed for recursive expansion
  --recursive-exclude RECURSIVE_EXCLUDE
                        File extensions excluded from recursive expansion

Maintainers

• @stanislav-web https://github.com/stanislav-web (Developer)

Tests

python3 -m pip install -r requirements-dev.txt
python3 -m unittest

Build

python3 -m pip install -r requirements-dev.txt
python3 -m build

Lint

python3 -m pip install -r requirements-dev.txt
ruff check .

Contributors

If you like to contribute to the development of the project, in that case, pull requests are open for you. Also, you can suggest ideas and create a task in my track list.

Documentation

• Read The Docs
• Opendoor OWASP CookBook
• Issues
• PyPI package