# 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!
Raw data
{
"_id": null,
"home_page": "https://mrfidal.in/cyber-security/subspy",
"name": "subspy",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "subspy, subdomain, enumeration, scanning, mrfidal, cyber security",
"author": "Fidal",
"author_email": "mrfidal@proton.me",
"download_url": "https://files.pythonhosted.org/packages/26/d8/bca43ae31f88349730c15748d80834f775043470ef27a1803a4e0c6f8a16/subspy-2.2.3.tar.gz",
"platform": null,
"description": "# Subspy\r\n\r\nSubspy 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.\r\n\r\n## Benefits\r\n- **Efficiency**: Quickly identify potential attack surfaces and gather information about a target's infrastructure.\r\n- **Flexibility**: Customize subdomain tests using custom subdomain lists or default lists included in the tool.\r\n- **Ease of Use**: Simple command-line interface with clear options and informative output.\r\n- **Versatility**: Save results to files for further analysis or reporting.\r\n\r\n## Installation\r\n\r\nInstall Subspy using pip:\r\n\r\n```bash\r\npip install subspy\r\n```\r\n\r\n## Usage\r\n\r\n```bash\r\nsubspy --url https://example.com\r\n```\r\n\r\n### Command Line Options\r\n- **--url** : The base URL to test subdomains against (e.g., https://example.com).\r\n- **--sub-list** : The file containing a list of subdomains to test.\r\n- **--save** : Save the output to a file.\r\n- **--version** : Show the version of the tool.\r\n- **--silent** : Suppress output of wrong subdomains, only print found subdomains.\r\n- **--time** : Run the tool for a specific amount of time (e.g., 5m, 50s, 1h).\r\n\r\n### Examples\r\n- Test subdomains for a specific URL:\r\n```bash\r\nsubspy --url https://example.com\r\n```\r\n- Specify a custom subdomain list file:\r\n```bash\r\nsubspy --url https://example.com --sub-list subdomains.txt\r\n```\r\n- Save the output to a file:\r\n```\r\nsubspy --url https://example.com --save output.txt\r\n````\r\n- Run in silent mode (only print found subdomains):\r\n```bash\r\nsubspy --url https://example.com --silent\r\n````\r\n- Run the tool for a specific amount of time:\r\n```bash\r\nsubspy --url https://example.com --time 5m\r\n```\r\n- Combine silent mode and time limit:\r\n```bash\r\nsubspy --url https://example.com --silent --time 1h\r\n```\r\n- Show the version of the tool:\r\n```bash\r\nsubspy --version\r\n```\r\n\r\n### Disclaimer\r\n\r\nThis 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.\r\n\r\n### Thanks\r\n\r\nThank you \u2764 for using Subspy and supporting open-source tools!\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "SubSpy: A tool for subdomain enumeration.",
"version": "2.2.3",
"project_urls": {
"Homepage": "https://mrfidal.in/cyber-security/subspy"
},
"split_keywords": [
"subspy",
" subdomain",
" enumeration",
" scanning",
" mrfidal",
" cyber security"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ad69dba2ad1f73859051e5636afdce118a540c4ae2cebe1e78df72326ec50abe",
"md5": "15175de48de9423168dc0059da34536f",
"sha256": "f2e1281fe2565e93222e3e1367510945c4fb56bcf3e417a1303455abb61ee8db"
},
"downloads": -1,
"filename": "subspy-2.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "15175de48de9423168dc0059da34536f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 40106,
"upload_time": "2024-06-01T07:16:51",
"upload_time_iso_8601": "2024-06-01T07:16:51.903248Z",
"url": "https://files.pythonhosted.org/packages/ad/69/dba2ad1f73859051e5636afdce118a540c4ae2cebe1e78df72326ec50abe/subspy-2.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "26d8bca43ae31f88349730c15748d80834f775043470ef27a1803a4e0c6f8a16",
"md5": "bb86c6e9fb729924437853061fab9a59",
"sha256": "ec95f6c35ea378cf6b402a0fb00ea572dd99d103f43e3ef654628f577da7cf15"
},
"downloads": -1,
"filename": "subspy-2.2.3.tar.gz",
"has_sig": false,
"md5_digest": "bb86c6e9fb729924437853061fab9a59",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 41073,
"upload_time": "2024-06-01T07:16:54",
"upload_time_iso_8601": "2024-06-01T07:16:54.578420Z",
"url": "https://files.pythonhosted.org/packages/26/d8/bca43ae31f88349730c15748d80834f775043470ef27a1803a4e0c6f8a16/subspy-2.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-01 07:16:54",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "subspy"
}