WhatsMyName Python Script V1.3 🔍

As a regular contributor to Project WhatsMyName, this is a Python script I made for myself.

The script is unofficial and is not part of Project WhatsMyName.

Feel free to use it!

---

Support ♡

There is no support button on this repository. This is because WhatsMyName is not my project — this is my own personal script. All support should go to Project WhatsMyName and to @WebBreacher. DO NOT DONATE TO ME.

---

License ©

I am a regular contributor to Project WhatsMyName, but I am not officially part of its creation. WMN is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Copyright (C) Micah Hoffman

---

Installation ⚙️

Option 1 — pipx (recommended)

Install once, and the whatsmyname command becomes available globally in your terminal — no virtual environment management, no path hassle.

pipx install git+https://github.com/C3n7ral051nt4g3ncy/WhatsMyName-Python.git

To update to the latest version at any time:

pipx upgrade WhatsMyName-Python

To uninstall:

pipx uninstall WhatsMyName-Python

Option 2 — Classic git clone

git clone https://github.com/C3n7ral051nt4g3ncy/WhatsMyName-Python
cd WhatsMyName-Python
pip install -r requirements.txt

---

Usage 📖

pipx install users

Once installed via pipx, just run whatsmyname from anywhere:

whatsmyname -u <username>

git clone users

python3 whatsmyname.py -u <username>

---

Commands

• Help:

whatsmyname -h

• Count the number of sites currently supported on Project WhatsMyName:

whatsmyname -c

• Full sites list supported on Project WhatsMyName:

whatsmyname -f

• Scan the full sites list for a target username:

whatsmyname -u johndoe

• Single site search — check if a username exists on a specific site:

whatsmyname -u johndoe -s "Bluesky 2"

• Control output files — skip formats you don't need:

whatsmyname -u johndoe --no-csv --no-json   # HTML report only
whatsmyname -u johndoe --no-html            # JSON + CSV only

• Tune concurrency — adjust the number of parallel workers (default: 20):

whatsmyname -u johndoe --workers 40

---

Screenshot 📸

---

Output & Reports 📊

Every scan automatically generates three output files, all timestamped so repeated scans never overwrite each other:

File	Format	Contents
wmn_<user>_<timestamp>.html	HTML	Colour-coded report with a found-accounts summary at the top, then the full results table with a live filter
wmn_<user>_<timestamp>.json	JSON	Full structured log — every site checked, with status, HTTP code, response time, and any error message
wmn_<user>_<timestamp>.csv	CSV	Spreadsheet-friendly log of all results, easy to import into other tools

All three files are saved in whichever directory you run the command from.

---

Latest Improvements 🚀

Version 1.3

• uri_pretty support: when a site defines a uri_pretty field in the WMN dataset, the clean human-facing profile URL is shown in all output — terminal, HTML, JSON, and CSV — instead of the internal check URL which may point to an API endpoint. Sites without uri_pretty fall back to uri_check automatically.
• Full response logging: all sites are now logged, not just hits. Every result — found, not found, or error — is recorded with its HTTP status code, response time in milliseconds, and error message if applicable.
• Three output formats: JSON, CSV, and HTML are all generated automatically at the end of each scan. Individual formats can be skipped with --no-html, --no-csv, or --no-json.
• Timestamped output files: repeated scans no longer overwrite previous reports.
• pipx support: the script can now be installed globally via pipx without cloning the repo.
• --workers flag: concurrency is now configurable from the command line.
• Proper error handling: each site failure is caught and recorded with the actual exception message instead of being silently discarded.
• HTML report improvements: found accounts appear in a dedicated green summary table at the top of the report, followed by the full colour-coded results table with a live search filter.

Version 1.2

• Improved code structure and separation of concerns.
• Fixed progress bar bug where pbar was referenced outside its with block.

Version 1.1

• Links made clickable in the HTML report. Special thanks to boringthegod for the request and idea.
• Scan speed significantly improved while maintaining accuracy.
• HTML Report Generation: a .html report is generated at the end of each scan with all found links in one place.

---

Contributors 🎉

Huge thanks to the following contributors for their valuable contributions to this project:

@hippiiee

@ljrk0

@Webbreacher

To add yourself to this list, please make a pull request with your GitHub username.