bee-san/pyWhat
Identify anything. pyWhat easily lets you identify emails, IP addresses, and more. Feed it a .pcap file or some text and it'll tell you what it is!
repo name | bee-san/pyWhat |
repo link | https://github.com/bee-san/pyWhat |
homepage | |
language | Python |
size (curr.) | 3474 kB |
stars (curr.) | 3542 |
created | 2021-03-19 |
license | GNU General Public License v3.0 |
๐ค What
is this?
Imagine this: You come across some mysterious text ๐งโโ๏ธ 5f4dcc3b5aa765d61d8327deb882cf99
and you wonder what it is. What do you do?
Well, with what
all you have to do is ask what "5f4dcc3b5aa765d61d8327deb882cf99"
and what
will tell you!
what
’s job is to identify what something is. Whether it be a file or text! Or even the hex of a file! What about text within files? We have that too! what
is recursive, it will identify everything in text and more!
โ Use Cases
๐ฆ Wannacry
You come across a new piece of malware called WantToCry. You think back to Wannacry and remember it was stopped because a researcher found a kill-switch in the code.
When a domain, hardcoded into Wannacry, was registered the virus would stop.
You use What
to identify all the domains in the malware, and use a domain registrar API to register all the domains. If Wannacry happens again, you can stop it in minutes - not weeks.
๐ฆ Faster Analysis of Pcap files
Say you have a .pcap
file from a network attack. What
can identify this and quickly find you:
- All hashes
- Credit card numbers
- Cryptocurrency addresses
- Social Security Numbers
- and much more.
With what
, you can identify the important things in the pcap in seconds, not minutes.
๐ Anything
Anytime you have a file and you want to find structured data in it that’s useful, What
is for you.
Or if you come across some piece of text and you don’t know what it is, What
will tell you.
File Opening You can pass in a file path by what 'this/is/a/file/path'
. What
is smart enough to figure out it’s a file!
What about a whole directory? What
can handle that too! It will recursively search for files and output everything you need!
Filtration You can filter output by using what --rarity 0.2:0.8 --include_tags tag1,tag2 TEXT
. Use what --help
to get more information.
Sorting You can sort the output by using what -k rarity --reverse TEXT
. Use what --help
to get more information.
๐ API
PyWhat has an API! Click here https://github.com/bee-san/pyWhat/wiki/API to read about it.
๐พ Contributing
what
not only thrives on contributors, but can’t exist without them! If you want to add a new regex to check for things, you can read our documentation here
We ask contributors to join the Discord for quicker discussions, but it’s not needed: