DEV Community

Cover image for User Scanner : Find Your Perfect Username Across All Platforms in Seconds ⚡
kaifcodec
kaifcodec

Posted on

User Scanner : Find Your Perfect Username Across All Platforms in Seconds ⚡

#python #opensource #github #osint

🚀 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
Enter fullscreen mode Exit fullscreen mode

🧭 Usage

Scan a username across all supported platforms:

user-scanner -u <username>
Enter fullscreen mode Exit fullscreen mode

Scan only a specific category:

user-scanner -u <username> -c dev
Enter fullscreen mode Exit fullscreen mode

List modules:

user-scanner -l
Enter fullscreen mode Exit fullscreen mode

Scan a single module:

user-scanner -u <username> -m github
Enter fullscreen mode Exit fullscreen mode

📊 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

  ...
  ...
  ...
Enter fullscreen mode Exit fullscreen mode

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.)
Enter fullscreen mode Exit fullscreen mode

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 (1)

Collapse
 
kaifcodec profile image
kaifcodec •

Actively looking for feedbacks and contributions for improvement of it.