Skip to main content

Check username availability across multiple popular platforms

Project description

User Scanner

1000136215


Scan a username across multiple social, developer, and creator platforms to see if it’s available.
Perfect for finding a unique username across GitHub, Twitter, Reddit, Instagram, and more, all in one command.

Features

  • ✅ Check usernames across social networks, developer platforms, and creator communities.
  • ✅ Clear Available / Taken / Error output for each platform.
  • ✅ Fully modular: add new platform modules easily.
  • ✅ Wildcard-based username permutations for automatic variation generation
  • ✅ Command-line interface ready: works directly after pip install.
  • ✅ Can be used as username OSINT tool.
  • ✅ Very low and lightweight dependencies, can be run on any machine.

Installation

pip install user-scanner

Usage

Scan a username across all platforms:

user-scanner -u <username>

Optionally, scan a specific category or single module:

user-scanner -u <username> -c dev
user-scanner -l # Lists all available modules
user-scanner -u <username> -m github
user-scanner -u <username> -p <suffix> 

Generate multiple username variations by appending a suffix:

user-scanner -u <username> -p <suffix> 

Optionally, scan a specific category or single module with limit:

user-scanner -u <username> -p <suffix> -c dev
user-scanner -u <username> -p <suffix> -m github
user-scanner -u <username> -p <suffix> -s <number> # limit generation of usernames
user-scanner -u <username> -p <suffix> -d <seconds> #delay to avoid rate-limits

Screenshot:

  • Note*: New modules are constantly getting added so this might have only limited, outdated output:
1000140392
1000140393

Contributing:

Modules are organized by category:

user_scanner/
├── dev/        # Developer platforms (GitHub, GitLab, etc.)
├── social/     # Social platforms (Twitter/X, Reddit, Instagram, etc.)
├── creator/    # Creator platforms (Hashnode, Dev.to, Medium, etc.)
├── community/  # Community platforms (forums, niche sites)
├── gaming/     # Gaming sites (chess.com, roblox, monkeytype etc.)
├── donation/   # Donation taking sites (buymeacoffe.com, similar...)

Module guidelines:

  • Each module must define a validate_<site>() function that takes a username and returns:
    • 1 → Available
    • 0 → Taken
    • 2 → Error / Could not check
  • Use httpx for requests, colorama for colored output.
  • Optional: modules can define a CLI parser if they support custom arguments.

See CONTRIBUTING.md for examples.


Dependencies:


License

This project is licensed under the MIT License. See LICENSE for details.


Star History

Star History Chart

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

user_scanner-1.0.8.0.tar.gz (16.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

user_scanner-1.0.8.0-py3-none-any.whl (35.2 kB view details)

Uploaded Python 3

File details

Details for the file user_scanner-1.0.8.0.tar.gz.

File metadata

  • Download URL: user_scanner-1.0.8.0.tar.gz
  • Upload date:
  • Size: 16.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.31.0

File hashes

Hashes for user_scanner-1.0.8.0.tar.gz
Algorithm Hash digest
SHA256 383ff220389be2883a849849e903561461868926c982436dd1cde2f9816967f9
MD5 e7fd009fb8a1cf7359c0d0ca1184d182
BLAKE2b-256 8d4362a7a8ebfccc305e872944aba51221433ec6a04c7afce16aa053fb1c282a

See more details on using hashes here.

File details

Details for the file user_scanner-1.0.8.0-py3-none-any.whl.

File metadata

File hashes

Hashes for user_scanner-1.0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 29f7e8b07a16024507a85470034a6a8d952253f2fe5c321f6831eb5dbd865e8d
MD5 78149676ade4920e29d30c29b31cd9a7
BLAKE2b-256 87771ea6a60a8b3b2fe6e998cbf6700abd5456560a2f7887f0396dd402b74563

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page