Metadata-Version: 2.3
Name: mira_recon
Version: 0.3.8
Summary: A reconnaissance tool for information gathering
Keywords: reconnaissance,information gathering,security,tool
Author-email: Liam Halliden <lhallidenw@gmail.com>
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: MIT License
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Requires-Dist: builtwith
Requires-Dist: python-whois
Project-URL: Documentation, https://github.com/HaldenLF/Mira
Project-URL: Source, https://github.com/HaldenLF/Mira

# Mira

![Image of help menu for tool](https://github.com/HaldenLF/mira-recon/blob/main/mira_recon.png)



## About
Mira is a recon tool written in python. Its goal is to eliminate some of the tedious tasks in information gathering. Its great when used as a starting point.

## Main Features
* DNS scan
* Subdomain scan using wordlist
* Technology scan using whatweb and builtwith
* Custom port scanner
> note this was designed for use mainly on Linux distros so some features do not work fully on mac and Windows.

## Roadmap
* improve visual layout
* Web scraper
* Web crawler and DNS info of each url crawled
* wayback data
* generate report with findings

## Version
v0.3.7

## Installation
> requires python3 and pip

> ### Linux and macOS path configuration
> ```
> echo 'export PATH="~/.local/bin:$PATH"' >> ~/.bashrc
> source ~/.bashrc
> ```

> ### Steps for installing on all OS
> ```
> pip install mira_recon
> ```
> ```
> python (or python3)
> 
> >>> import mira_recon
> >>> quit()
> ```
> 
> ```
> mira_recon -h
> ```
> If you run into errors like `command not found` double check the path


## Contribute
If you're interested in contributing to the project, please do! <br />
I am constantly looking for ways to improve and add new features, and your contributions can help make this tool even more powerful and useful.<br />

## Some ways to contribute
* Report bugs or request new features by creating an issue on our GitHub repository.🐛
* Help us improve the documentation by submitting updates or corrections.📚
* Contribute code by submitting pull requests with bug fixes or new features.💻
* Any help is greatly appreciated


