{"id":13541821,"url":"https://github.com/nexxai/Substr3am","last_synced_at":"2025-04-02T09:32:48.781Z","repository":{"id":56599049,"uuid":"181211041","full_name":"nexxai/Substr3am","owner":"nexxai","description":"Passive reconnaissance/enumeration of interesting targets by watching for SSL certificates being issued","archived":false,"fork":false,"pushed_at":"2022-10-11T18:01:10.000Z","size":34,"stargazers_count":64,"open_issues_count":0,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-06-15T00:46:19.449Z","etag":null,"topics":["certstream","dns","python","ssl","subdomain-enumeration"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nexxai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-13T18:12:20.000Z","updated_at":"2024-01-19T23:20:33.000Z","dependencies_parsed_at":"2023-01-19T19:20:59.059Z","dependency_job_id":null,"html_url":"https://github.com/nexxai/Substr3am","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexxai%2FSubstr3am","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexxai%2FSubstr3am/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexxai%2FSubstr3am/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexxai%2FSubstr3am/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nexxai","download_url":"https://codeload.github.com/nexxai/Substr3am/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213503445,"owners_count":15597030,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["certstream","dns","python","ssl","subdomain-enumeration"],"created_at":"2024-08-01T10:00:57.400Z","updated_at":"2024-08-01T10:03:31.935Z","avatar_url":"https://github.com/nexxai.png","language":"Python","funding_links":[],"categories":["Recon"],"sub_categories":["Subdomain Enumeration"],"readme":"# Substr3am\n\nSubstr3am is a python tool inspired by [subbrute](https://github.com/TheRook/subbrute) and [Sublist3r](https://github.com/aboul3la/Sublist3r) designed to generate a list of potential subdomains using the [certstream](https://github.com/CaliDog/certstream-python) service. It helps penetration testers and bug hunters collect and gather subdomains for their lists by connecting to the certstream firehose, watching for real subdomains, and adding them to a list for use with the above tools.\n\n## Installation\n\n```\ngit clone https://github.com/nexxai/Substr3am.git\n```\n\n## Recommended Python Version:\n\nSubstr3am currently supports **Python 3**.  Stop using **Python 2**.  I suck at Python and even I know that.\n\n* The recommended version for Python 3 is **3.8.x**\n\nNOTE: There is currently an issue with a dependency and Python v3.9 so do not upgrade to that version for now as you will receive websockets errors until the dependency is updated.\n\n## Dependencies:\n\nSubstr3am depends on the `certstream`, `argparse`, `tldextract`, and `sqlalchemy` python modules.\n\nThese dependencies can be installed using the requirements file:\n\n- Installation on Windows:\n```\nc:\\python\\python.exe -m pip install -r requirements.txt\n```\n- Installation on Linux / MacOS:\n```\nsudo pip3 install -r requirements.txt\n```\n\n## Usage\n\nShort Form               | Long Form                      | Description\n------------------------ | ------------------------------ |-------------\n`./Substr3am`              |                                | Start collecting subdomains and write them to the subdomains.db sqlite DB\n`./Substr3am -f [DOMAINS]` | `./Substr3am --filter [DOMAINS]` | A space-separated list of domain names to filter for (e.g. 'google.com' or 'tesco.co.uk tesco.com harrods.com').  *BE PATIENT* - if you are filtering by domain(s), there will only be activity when new certs are issued so just let it run and it'll announce when it sees any new ones.\n`./Substr3am -d`           | `./Substr3am --dump`             | Dump the list of collected subdomains to names.txt\n\n### Examples\n\n* To only return results for a particular list of domains\n\n```python3 Substr3am.py -f google.com google.cn microsoft.com uber.com```\n\n* To export your collected subdomains from the sqlite DB to a file called 'names.txt\n\n```python3 Substr3am.py -d```\n\n## License\n\nSubstr3am is licensed under the GNU GPL license. take a look at the [LICENSE](https://github.com/nexxai/Substr3am/blob/master/LICENSE) for more information.\n\n## Credits\n\n* [aboul3la](https://github.com/aboul3la) - Substr3am's code was inspired by his wonderful tool **Sublist3r**\n* [CaliDog](https://github.com/CaliDog) - For providing the awesome **certstream** service\n\n## Version\n**Current version is 1.0**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexxai%2FSubstr3am","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnexxai%2FSubstr3am","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexxai%2FSubstr3am/lists"}