Metadata-Version: 2.4
Name: dirhunt
Version: 1.0.0
Summary: Find web directories without bruteforce
Home-page: https://github.com/Nekmo/dirhunt
Download-URL: https://github.com/Nekmo/dirhunt/archive/master.zip
Author: Nekmo
Author-email: contacto@nekmo.com
Keywords: directories,websec,pentesting,security-audit
Platform: linux
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Natural Language :: English
Classifier: Development Status :: 3 - Alpha
Provides: dirhunt
License-File: LICENSE.txt
License-File: AUTHORS.rst
Requires-Dist: beautifulsoup4
Requires-Dist: requests
Requires-Dist: click<8
Requires-Dist: humanize
Requires-Dist: colorama
Requires-Dist: requests-mock
Requires-Dist: google
Requires-Dist: proxy-db
Requires-Dist: futures; python_version < "3.0"
Requires-Dist: py2-ipaddress; python_version < "3.0"
Requires-Dist: greenlet>=3.0.0a1; python_version >= "3.12"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: platform
Dynamic: provides
Dynamic: requires-dist
Dynamic: summary


.. image:: https://raw.githubusercontent.com/Nekmo/dirhunt/v0.2.0/images/dirhunt.png

|

.. image:: https://raw.githubusercontent.com/Nekmo/dirhunt/pip-rating-badge/pip-rating-badge.svg
  :target: https://github.com/Nekmo/dirhunt/actions/workflows/pip-rating.yml
  :alt: pip-rating badge

.. image:: https://img.shields.io/github/actions/workflow/status/Nekmo/dirhunt/test.yml?style=flat-square&maxAge=2592000&branch=develop
  :target: https://github.com/Nekmo/dirhunt/actions?query=workflow%3ATests
  :alt: Latest Tests CI build status

.. image:: https://img.shields.io/pypi/v/dirhunt.svg?style=flat-square
  :target: https://pypi.org/project/dirhunt/
  :alt: Latest PyPI version

.. image:: https://img.shields.io/pypi/pyversions/dirhunt.svg?style=flat-square
  :target: https://pypi.org/project/dirhunt/
  :alt: Python versions

.. image:: https://img.shields.io/codeclimate/maintainability/Nekmo/dirhunt.svg?style=flat-square
  :target: https://codeclimate.com/github/Nekmo/dirhunt
  :alt: Code Climate

.. image:: https://img.shields.io/codecov/c/github/Nekmo/dirhunt/master.svg?style=flat-square
  :target: https://codecov.io/github/Nekmo/dirhunt
  :alt: Test coverage

.. image:: https://img.shields.io/github/stars/Nekmo/dirhunt?style=flat-square
     :target: https://github.com/Nekmo/dirhunt
     :alt: Github stars


Dirhunt
#######

.. image:: https://asciinema.org/a/xPJXT0MhrvlZ8lJYJYkjxlice.png
     :target: https://asciinema.org/a/xPJXT0MhrvlZ8lJYJYkjxlice
     :align: center
     :alt: Dirhunt Demo Video


Dirhunt is a web crawler optimize for **search and analyze directories**. This tool can find interesting things if the
server has the *"index of"* mode enabled. Dirhunt is also useful if the directory listing is not enabled. It detects
directories with **false 404 errors**, directories where an **empty index file** has been created to hide things and
much more.

.. code-block:: console

    $ dirhunt http://website.com/

Dirhunt does not use brute force. But neither is it just a **crawler**. This tool is faster than others because it
minimizes requests to the server. Generally, this tool takes **between 5-30 seconds**, depending on the website and
the server.

Read more about **how to use** Dirhunt `in the documentation <http://docs.nekmo.org/dirhunt/usage.html>`_.


Features
========

* Process **one or multiple sites** at a time.
* Process *'Index Of'* pages and report interesting files.
* Detect **redirectors**.
* Detect **blank index file** created on directory to hide things.
* Process some html files in search of new directories.
* 404 error pages and detect **fake 404 errors**.
* Filter results by **flags**.
* Analyze results at end. It also **processes date & size** of the Index Pages.
* Get new directories using **robots.txt**, **VirusTotal**, **Google**, **CommonCrawl** (NEW!),
  **SSL Certificate** (NEW!), **Crt.sh** (NEW!) & **Wayback** (NEW!).
* **Delay** between requests.
* One or multiple **proxies** option. It can also search for **free proxies**.
* **Save the results** to a JSON file
* **Resume** the aborted scans


Install
=======
If you have Pip installed on your system, you can use it to install the latest Dirhunt stable version::

    $ sudo pip3 install dirhunt

Python 2.7 & 3.7-3.12 are supported but Python 3.x is recommended. Use ``pip2`` on install for Python2.

There are other `installation methods <http://docs.nekmo.org/dirhunt/installation.html>`_ available.


Disclaimer
==========
This software must not be used on third-party servers without permission. Dirhunt has been created to be used by audit
teams with the consent of the owners of the website analyzed. The author is not responsible for the use of this tool
outside the law.

This software is under the MIT license. The author does not provide any warranty. But issues and pull requests are
welcome.
