🚀 User Scanner: Find Your Perfect Username Across All Platforms in Seconds ⚡
Tired of opening tabs and hunting site-by-site to see if your favorite username is taken?
User Scanner fixes that , fast, from your terminal, with clear color-coded output. Perfect for developers, creators, and anyone who wants a consistent online identity without the busywork.
💡 What It Does
- ✅ Scans social, developer, and creator platforms in a single run (GitHub, Reddit, X, Instagram, YouTube, and more).
- ✅ Produces a clear Available / Taken / Error report with colored CLI output.
- ✅ Fully modular → add new platform modules easily.
- ✅ CLI-ready after a single
pip install. - ✅ Useful for quick username OSINT, branding checks, and onboarding automation.
⚙️ Installation
Run:
pip install user-scanner
🧭 Usage
Scan a username across all supported platforms:
user-scanner -u <username>
Scan only a specific category:
user-scanner -u <username> -c dev
List modules:
user-scanner -l
Scan a single module:
user-scanner -u <username> -m github
📊 Example Output
bash
Checking username: johndoe07
== DEV SITES ==
[✔] Codeberg: Available
[✔] Cratesio: Available
[✘] Dockerhub: Taken
[✘] Github: Taken
[✔] Gitlab: Available
[✔] Launchpad: Available
[✔] Npmjs: Available
[✘] Replit: Taken
== SOCIAL SITES ==
[✘] Bluesky: Taken
[✘] Instagram: Taken
[✘] Mastodon: Taken
[✘] Pinterest: Taken
[✘] Reddit: Taken
[✘] Snapchat: Taken
[✘] Threads: Taken
[✘] X (Twitter): Taken
[✔] Youtube: Available
== CREATOR SITES ==
[✔] Devto: Available
[✔] Hashnode: Available
[✘] Kaggle: Taken
[!] Medium: Error
[✔] Patreon: Available
== COMMUNITY SITES ==
[✔] Coderlegion: Available
== GAMING SITES ==
[✘] Chess_com: Taken
...
...
...
Color-coded output gives an instant snapshot of what's free and what isn't, no more manual checking.
🧩 How It’s Built
Project layout (modules by category):
user_scanner/
├── dev/ # Developer platforms (GitHub, GitLab, npm, etc.)
├── social/ # Social platforms (X, Reddit, Instagram, etc.)
├── creator/ # Creator platforms (Hashnode, Dev.to, Medium, etc.)
├── community/ # Community or niche sites
├── gaming/ # Gaming-related platforms (chess.com, itch, etc.)
Each platform module implements a validate_<site>() function that returns:
-
1→ Available -
0→ Taken -
2→ Error / Could not check
Tech:
-
httpx→ fast HTTP requests (async-friendly) -
colorama→ readable colored CLI output
🤝 Want to Contribute?
The community and gaming categories are still small, contributions welcome.
Follow the module guideline in CONTRIBUTING.md and add your site module. Keep modules simple: a validate_<site>() function returning 1/0/2 and using httpx for checks.
🔗 Links
Repo: https://github.com/kaifcodec/user-scanner
Contributing guide: https://github.com/kaifcodec/user-scanner/blob/main/CONTRIBUTING.md
Have a favorite site that's missing? Add it, pull requests encouraged. Want help writing a module or testing a new platform? Ping me on the issue tracker and we’ll get it merged.
Top comments (11)
Actively looking for feedbacks and contributions for improvement of it.
Looks like a nice project with unique.
The codebase is very contributor friendly.
Thanks!
This is really useful - but could you create a web based version? I think users would love that
Thanks! Do you mean a hosted web version (like websites), or a local one that runs via Flask/FastAPI on localhost?
A hosted web version would be really nice
Thanks! A hosted version would be great, but the project’s still small, not enough supported sites yet. A public one would also need regular maintenance since sites change and rate limits hit often. For now, I’m keeping it CLI-focused until it’s bigger and more stable. If you’re into web requests or site integrations, feel free to contribute, more hands will speed things up.
Why is it necessary to digitize these systems?
I didn't really understand what you asked, can you clarify a little bit?
Good App!
Thanks! Feel free to check it out by yourself and suggest any fixes or features.