{"id":13844673,"url":"https://github.com/junnlikestea/vita","last_synced_at":"2025-07-12T00:31:04.349Z","repository":{"id":54938533,"uuid":"274126524","full_name":"junnlikestea/vita","owner":"junnlikestea","description":"A tool to find subdomains or domains from passive sources.","archived":false,"fork":false,"pushed_at":"2021-01-20T12:32:04.000Z","size":241,"stargazers_count":106,"open_issues_count":2,"forks_count":16,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-05T17:42:51.640Z","etag":null,"topics":["bugbounty-tool","osint","rust","subdomain-enumeration","vita"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/junnlikestea.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":"2020-06-22T12:07:58.000Z","updated_at":"2024-07-15T16:53:52.000Z","dependencies_parsed_at":"2022-08-14T07:01:12.781Z","dependency_job_id":null,"html_url":"https://github.com/junnlikestea/vita","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junnlikestea%2Fvita","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junnlikestea%2Fvita/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junnlikestea%2Fvita/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/junnlikestea%2Fvita/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/junnlikestea","download_url":"https://codeload.github.com/junnlikestea/vita/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225772723,"owners_count":17521878,"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":["bugbounty-tool","osint","rust","subdomain-enumeration","vita"],"created_at":"2024-08-04T17:02:51.428Z","updated_at":"2024-11-21T17:30:40.138Z","avatar_url":"https://github.com/junnlikestea.png","language":"Rust","funding_links":[],"categories":["Rust (42)","Rust"],"sub_categories":[],"readme":"# Vita\n![release](https://github.com/junnlikestea/vita/workflows/release/badge.svg)\n[![Build status](https://github.com/junnlikestea/vita/workflows/Continuous%20integration/badge.svg)](https://github.com/junnlikestea/vita/actions)\n\nVita is a tool to gather subdomains from passive sources much like [tomnomnom's assetfinder](https://github.com/tomnomnom/assetfinder).\n\n\n### Installation\nPrecompiled binaries for vita are available in the [releases](https://github.com/junnlikestea/vita/releases) tab. Just pick your platform and extract the archive that contains the binary.\n\n### Building it yourself \nIf you want to build it yourself you will need to install Rust, you can get the [official installation](https://www.rust-lang.org/tools/install) from the Rust website.\n\nTo build Vita:\n```\n$ git clone https://github.com/junnlikestea/vita\n$ cd vita\n$ cargo build --release\n$ ./target/release/vita --version\n```\n\n### Usage\n\n**With a single domain and collecting data from free sources**\n\n```\nvita -d hackerone.com\n```\nBy default the results will be unique, and will filter subdomains not related \nto your root domain, or domains if you choose to supply multiple.\n\n**Collecting data only on a specific subdomain**\n\nIf you only want to collect results related to a specific subdomain you can use\nthe `--subs-only` flag. This will cause vita to run on the actual domain and not\nthe root domain. Results will be filtered to anything that ends with the input\ndomain or domains.\n```\nvita -d api.hackerone.com --subs-only\n```\n\n**With a list of domains from a file**\n\n```\nvita -f path/to/domains.txt\n```\n\n**With a list of domains from stdin**\n\n```\nvita \u003c /path/to/domains.txt\n```\n\n**Outputting results as they're received**\n\nYou can output results as they arrive as opposed to once all sources finish using\nthe `--flush` flag. You might want to use this flag when you're running vita on a\nsmall vps without much memory. When this flag is active vita will not remove duplicates,\nso you may want to pipe it through something like `sort -u`.\n```\nvita -d hackerone.com --flush\n```\n\n**Collecting data using paid sources**\n\nIf you want to include sources which require API keys, add the `-a` or `-all` flag, for example:\n```\nvita -d hackerone.com -a\n``` \nBy default it will just ignore services you don't supply keys for.\n\n**Excluding sources**\n\nYou can exclude sources with the `-e` flag\n```\nvita -d hackerone.com -e Wayback\n```\n\nIf you would like some more verbose output you can use the `-v` flag. There are\ndifferent levels of verbosity ranging from noisy to informational, most of the\ntime I just use `info`. This is all printing to stderr, so it won't be captured\nin the results.\n* `info`: General information like how many results each source returned.\n* `debug`: Lots and lots of information about what's going on under the hood.\n```\nvita -d hackerone.com -v info\n```\n\n### Common error - Too many open files\nVita uses async concurrent http requests under the hood. If you encounter an error \nsimilar to *\"Too many open files\"* it means that there isn't enough available file descriptors on \nyour system. You can fix this by increasing the hard and soft limits. There are \nlots of different guides available to increase the limits [but here is one for linux](https://www.tecmint.com/increase-set-open-file-limits-in-linux/). \n\n### Sources\n* SonarSearch\n* C99\n* ProjectDiscovery Chaos\n* AnubisDB\n* Alienvault\n* Binaryedge \n* Certspotter\n* Crt.sh\n* Hackertarget\n* Threatcrowd\n* VirusTotal\n* Sublis3r\n* Security Trails\n* Spyse\n* Urlscan.io\n* Facebook\n* Threatminer\n* Wayback Machine\n* IntelligenceX\n* PassiveTotal\n\n### How to set your Api Keys\nAdd a `.env` file to the tool directory or add the following to your existing `.env` file:\n* Binaryedge:\n\t* Needs `BINARYEDGE_TOKEN` set\n* ProjectDiscovery Chaos\n\t* Needs `CHAOS_KEY` set\n* Facebook:\n\t* Needs `FB_APP_ID` and `FB_APP_SECRET` set.\n* Spyse:\n\t* Needs `SPYSE_TOKEN` set.\n* Security Trails:\n\t* Needs `SECURITY_TRAILS_KEY` set.\n* C99: \n\t* Needs `C99_KEY` set.\n* PassiveTotal:\n\t* Needs `PASSIVETOTAL_KEY` and `PASSIVETOTAL_SECRET` set\n\t* Can be found under the account settings page.\n* IntelligenceX:\n\t* Needs `INTELX_KEY` and `INTELX_URL` to be set\n\t* Can be found under the [developer tab](https://intelx.io/account?tab=developer)\n\nIf you hit rate limits or authentication fails, the source will just be ignored from the list of potential sources.\n\n### A note on tuning the concurrency\nCurrently Vita will limit the search for data to 200 root domains concurrently. If you would like to \nchange that limit you can use the `-c` flag:\n\n```\nvita -f /path/to/roots.txt -c 400\n``` \n\n### Thanks\n[0xatul](https://twitter.com/0xatul) For constant feedback and improvement ideas.\n\n[dee-see](https://github.com/dee-see) For the contributions and neat issues!\n\n[TomNomNom](https://twitter.com/TomNomNom) For inspiring me to write and release open source tools.\n\n[Cgboal](https://twitter.com/CalumBoal) For [SonarSearch](https://github.com/Cgboal/SonarSearch) \nwhich is a data source for Vita. \n\n[ProjectDiscovery](https://chaos.projectdiscovery.io/#/) For Chaos which is a great data source.\n\n\n\n\nThanks to all the data source providers, and everyone else I can't seem to remember at this point \nin time. I'll make sure to add you in the future.\n\n### To-do\n* Add more paid sources.\n* Write some documentation for the underlying library that Vita uses, and prepare publish to crates.io.\n* Clean up types and optimise performance further.\n\n### Disclaimer\nDevelopers have/has no responsibility or authority over any kind of:\n* Legal or Law infringement by third parties and users.\n* Malicious use capable of causing damage to third parties.\n* Illegal or unlawful use of vita.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunnlikestea%2Fvita","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjunnlikestea%2Fvita","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunnlikestea%2Fvita/lists"}