Metadata-Version: 2.1
Name: subspy
Version: 2.2.3
Summary: SubSpy: A tool for subdomain enumeration.
Home-page: https://mrfidal.in/cyber-security/subspy
Author: Fidal
Author-email: mrfidal@proton.me
License: MIT
Keywords: subspy,subdomain,enumeration,scanning,mrfidal,cyber security
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Security
Description-Content-Type: text/markdown
Requires-Dist: requests

# Subspy

Subspy is a powerful subdomain enumeration tool designed to help you discover subdomains for a given base URL. It provides a comprehensive set of features and options to enhance your subdomain reconnaissance process.

## Benefits
- **Efficiency**: Quickly identify potential attack surfaces and gather information about a target's infrastructure.
- **Flexibility**: Customize subdomain tests using custom subdomain lists or default lists included in the tool.
- **Ease of Use**: Simple command-line interface with clear options and informative output.
- **Versatility**: Save results to files for further analysis or reporting.

## Installation

Install Subspy using pip:

```bash
pip install subspy
```

## Usage

```bash
subspy --url https://example.com
```

### Command Line Options
- **--url** : The base URL to test subdomains against (e.g., https://example.com).
- **--sub-list** : The file containing a list of subdomains to test.
- **--save** : Save the output to a file.
- **--version** : Show the version of the tool.
- **--silent** : Suppress output of wrong subdomains, only print found subdomains.
- **--time** : Run the tool for a specific amount of time (e.g., 5m, 50s, 1h).

### Examples
- Test subdomains for a specific URL:
```bash
subspy --url https://example.com
```
- Specify a custom subdomain list file:
```bash
subspy --url https://example.com --sub-list subdomains.txt
```
- Save the output to a file:
```
subspy --url https://example.com --save output.txt
````
- Run in silent mode (only print found subdomains):
```bash
subspy --url https://example.com --silent
````
- Run the tool for a specific amount of time:
```bash
subspy --url https://example.com --time 5m
```
- Combine silent mode and time limit:
```bash
subspy --url https://example.com --silent --time 1h
```
- Show the version of the tool:
```bash
subspy --version
```

### Disclaimer

This tool is provided for educational and informational purposes only. The author and contributors of Subspy are not responsible for any misuse or illegal activities performed using this tool.

### Thanks

Thank you ❤ for using Subspy and supporting open-source tools!
