user-scanner 1.0.0.3__py3-none-any.whl → 1.0.2.1__py3-none-any.whl

user_scanner/__init__.py

@@ -0,0 +1 @@
+

user_scanner/__main__.py

@@ -2,21 +2,26 @@ import argparse
 import re
 from user_scanner.core.orchestrator import run_checks, load_modules
 from colorama import Fore, Style
+from .cli import banner
+from .cli.banner import print_banner
+
 
 CATEGORY_MAPPING = {
     "dev": "dev",
     "social": "social",
     "creator": "creator",
-    "community": "community"
+    "community": "community",
+    "gaming": "gaming"
 }
 
 def list_modules(category=None):
-    from user_scanner import dev, social, creator, community
+    from user_scanner import dev, social, creator, community, gaming
     packages = {
         "dev": dev,
         "social": social,
         "creator": creator,
-        "community": community
+        "community": community,
+        "gaming": gaming
     }
 
     categories_to_list = [category] if category else packages.keys()
@@ -35,7 +40,7 @@ def main():
         description="Scan usernames across multiple platforms."
     )
     parser.add_argument(
-        "-u", "--username", help="Username to scan across platforms"
+        "-u", "--username",  help="Username to scan across platforms"
     )
     parser.add_argument(
         "-c", "--category", choices=CATEGORY_MAPPING.keys(),
@@ -57,17 +62,26 @@ def main():
         list_modules(args.category)
         return
 
+
+    # Special username checks before run
+    if (args.module == "x" or args.category == "social"):
+       if re.search(r"[^a-zA-Z0-9._-]", args.username):
+          print(Fore.RED + f"[!] Username '{args.username}' contains unsupported special characters. X (Twitter) doesn't support these." + Style.RESET_ALL)
+    if (args.module == "bluesky" or args.category == "social"):
+       if re.search(r"[^a-zA-Z0-9\.-]", args.username):
+          print(Fore.RED + f"[!] Username '{args.username}' contains unsupported special characters. Bluesky will throw error. (Supported: only hyphens and digits)" + Style.RESET_ALL +"\n")
     if not args.username:
-        print(Fore.RED + "[!] Please provide a username with -u or --username." + Style.RESET_ALL)
-        return
-    if re.search(r"[^a-zA-Z0-9._-]", args.username):
-        print(Fore.RED + f"[!] Username '{args.username}' contains unsupported special characters. X (Twitter) doesn't support these." + Style.RESET_ALL)
+       parser.print_help()
+       return
+    else:
+       print_banner()
+
 
-    from user_scanner import dev, social, creator, community
+    from user_scanner import dev, social, creator, community, gaming
 
     if args.module:
         # Single module search across all categories
-        packages = [dev, social, creator, community]
+        packages = [dev, social, creator, community, gaming]
         found = False
         for package in packages:
             modules = load_modules(package)

user_scanner/cli/banner.py

@@ -0,0 +1,39 @@
+import json
+from colorama import Fore, Style, init
+from ..utils.version import load_local_version
+
+
+version, version_type = load_local_version()
+init(autoreset=True)
+C_RED = Fore.RED + Style.BRIGHT
+C_CYAN = Fore.CYAN + Style.BRIGHT
+C_GREEN = Fore.GREEN + Style.BRIGHT
+C_WHITE = Fore.WHITE + Style.BRIGHT
+C_MAGENTA = Fore.MAGENTA + Style.BRIGHT
+BANNER_ASCII = fr"""{C_CYAN}      _   _ ___  ___ _ __      ___  ___ __ _ _ __  _ __   ___ _ __
+     | | | / __|/ _ \ '__|____/ __|/ __/ _` | '_ \| '_ \ / _ \ '__|
+     | |_| \__ \  __/ | |_____\__ \ (_| (_| | | | | | | |  __/ |
+      \__,_|___/\___|_|       |___/\___\__,_|_| |_|_| |_|\___|_| Version: {version}
+{Style.RESET_ALL}""".strip()
+
+INFO_BOX = f"""{C_MAGENTA}      ╔════════════════════════════════════════╗
+      ║ {C_RED}♚ {C_GREEN}Project Name{C_WHITE} : UserScanner           {C_MAGENTA}║
+      ║ {C_RED}♚ {C_GREEN}Author{C_WHITE} : Kaif                        {C_MAGENTA}║
+      ║ {C_RED}♚ {C_GREEN}Github{C_WHITE} : github.com/kaifcodec        {C_MAGENTA}║
+      ║ {C_RED}♚ {C_GREEN}Email{C_WHITE}  : kaifcodec@gmail.com         {C_MAGENTA}║
+      ══════════════════════════════════════════{Style.RESET_ALL}""".strip()
+
+def print_banner():
+    print(BANNER_ASCII)
+    print(INFO_BOX)
+    print(" ")
+if __name__ == "__main__":
+    print_banner()
+
+
+
+
+
+
+
+

user_scanner/community/coderlegion.py

@@ -0,0 +1,39 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+def validate_coderlegion(user):
+    url = f"https://coderlegion.com/user/{user}"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
+        'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
+        'Accept-Encoding': "gzip, deflate, br",
+        'Accept-Language': "en-US,en;q=0.9",
+    }
+    try:
+        response = httpx.get(url, headers=headers, timeout = 15.0)
+        status = response.status_code
+
+        if status == 200:
+           return 0
+        elif status == 404:
+           return 1
+        else:
+           return 2
+
+    except (ConnectError, TimeoutException):
+        return 2
+    except Exception:
+        return 2
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_coderlegion(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")
+

user_scanner/core/orchestrator.py

@@ -45,13 +45,14 @@ def run_checks_category(package, username, verbose=False):
 
 def run_checks(username):
 
-    from user_scanner import dev, social,creator, community
+    from user_scanner import dev, social,creator, community, gaming
 
     categories = [
         ("DEV", dev),
         ("SOCIAL", social),
         ("CREATOR", creator),
-        ("COMMUNITY", community)
+        ("COMMUNITY", community),
+        ("GAMING", gaming)
     ]
 
     print(f"\n{Fore.CYAN} Checking username: {username}{Style.RESET_ALL}\n")

user_scanner/creator/kaggle.py

@@ -10,17 +10,13 @@ def validate_kaggle(user):
     }
 
     try:
-        # Use GET request for maximum fidelity, though we only check status code
         response = httpx.get(url, headers=headers, timeout=3.0, follow_redirects=True)
         status = response.status_code
 
-        # If a profile exists (Taken) -> 200 OK
         if status == 200:
            return 0
-        # If no profile exists (Available) -> 404 Not Found
         elif status == 404:
            return 1
-        # Other status codes are errors
         else:
            return 2
 

user_scanner/creator/patreon.py

@@ -0,0 +1,45 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+def validate_patreon(user):
+    url = f"https://www.patreon.com/{user}"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
+        'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
+        'Accept-Encoding': "gzip, deflate, br",
+        'Accept-Language': "en-US,en;q=0.9",
+    }
+
+    try:
+        response = httpx.get(url, headers=headers, timeout = 15.0, follow_redirects=True)
+        status = response.status_code
+
+        if status == 200:
+           return 0
+        elif status == 404:
+           return 1
+        else:
+           return 2
+
+    except (ConnectError, TimeoutException):
+        return 2
+    except Exception:
+        return 2
+
+if __name__ == "__main__":
+   try:
+       import httpx
+   except ImportError:
+       print("Error: 'httpx' library is not installed.")
+       exit()
+
+   user = input ("Username?: ").strip()
+   result = validate_patreon(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")

user_scanner/gaming/chess_com.py

@@ -0,0 +1,54 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+import json
+
+def validate_chess_com(user):
+    url = f"https://www.chess.com/callback/user/valid?username={user}"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
+        'Accept': "application/json, text/plain, */*",
+        'Accept-Encoding': "identity",
+        'Accept-Language': "en-US,en;q=0.9",
+    }
+
+    try:
+        response = httpx.get(url, headers=headers, timeout = 3.0)
+        status = response.status_code
+
+        if status == 200:
+            data = response.json()
+            if data.get('valid') is True:
+                # 'valid': true means the username is NOT taken
+                return 1 
+            elif data.get('valid') is False:
+                # 'valid': false means the username IS taken
+                return 0
+            else:
+                return 2
+        else:
+           return 2
+
+    except (ConnectError, TimeoutException):
+        return 2
+    except json.JSONDecodeError:
+        return 2
+    except Exception:
+        return 2
+
+if __name__ == "__main__":
+   try:
+       import httpx
+   except ImportError:
+       print("Error: 'httpx' library is not installed.")
+       exit()
+
+   user = input ("Username?: ").strip()
+   result = validate_chess_com(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")

user_scanner/gaming/monkeytype.py

@@ -0,0 +1,63 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+import json
+
+def validate_monkeytype(user: str) -> int:
+
+    url = f"https://api.monkeytype.com/users/checkName/{user}"
+
+    headers = {
+        "User-Agent": (
+            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
+            "AppleWebKit/537.36 (KHTML, like Gecko) "
+            "Chrome/128.0.0.0 Safari/537.36"
+        ),
+        "Accept": "application/json, text/plain, */*",
+        "Accept-Encoding": "identity",
+        "Accept-Language": "en-US,en;q=0.9",
+    }
+
+    try:
+        response = httpx.get(url, headers=headers, timeout=3.0)
+        status = response.status_code
+
+        if status == 200:
+            data = response.json()
+            # Expected shape:
+            # { "message": "string", "data": { "available": true/false } }
+            payload = data.get("data", {})
+            available = payload.get("available")
+
+            if available is True:
+                return 1
+            elif available is False:
+                return 0
+            else:
+                return 2
+        else:
+            return 2
+
+    except (ConnectError, TimeoutException):
+        return 2
+    except json.JSONDecodeError:
+        return 2
+    except Exception:
+        return 2
+
+
+if __name__ == "__main__":
+    try:
+        import httpx  # noqa: F401
+    except ImportError:
+        print("Error: 'httpx' library is not installed.")
+        raise SystemExit(1)
+
+    user = input("Username?: ").strip()
+    result = validate_monkeytype(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occurred!")

user_scanner/gaming/osu.py

@@ -0,0 +1,44 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+def validate_osu(user):
+    """
+    Checks if a Osu username is available.
+    Returns: 1 -> available, 0 -> taken, 2 -> error
+    """
+    
+    url = f"https://osu.ppy.sh/users/{user}"
+    
+    headers = {
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36",
+        'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        'Accept-Encoding': "gzip, deflate, br",
+        'Accept-Language': "en-US,en;q=0.9",
+        'sec-fetch-dest': "document",
+    }
+    
+    try:
+        response = httpx.get(url, headers = headers, timeout = 5.0, follow_redirects = True)
+        status = response.status_code
+        
+        if status == 200:
+            return 0 
+        elif status == 404:
+            return 1
+        else:
+            return 2
+    except (ConnectError, TimeoutException):
+        return 2
+    except Exception:
+        return 2
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_osu(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occurred!")

user_scanner/gaming/roblox.py

@@ -0,0 +1,48 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+def validate_roblox(user):
+    """
+    Checks if a roblox username is available.
+    Returns: 1 -> available, 0 -> taken, 2 -> error
+    """
+
+    url = f"https://users.roblox.com/v1/users/search?keyword={user}&limit=10" # official api
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36",
+        'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        'Accept-Encoding': "gzip, deflate, br",
+        'Accept-Language': "en-US,en;q=0.9",
+        'sec-fetch-dest': "document",
+    }
+
+    try:
+        response = httpx.get(url, headers = headers, timeout = 5.5, follow_redirects = True)
+        status = response.status_code
+        search_results = response.json() # api response
+
+        if "errors" in search_results: # this usually triggers when timeout or ratelimit
+            return 2
+
+        for entry in search_results["data"]: # iterates through the entries in the search results
+            # .lower() so casing from the API doesn't matter
+            if entry["name"].lower() == user.lower(): # if a username matches the user
+                return 0
+        return 1
+
+    except (ConnectError, TimeoutException):
+        return 2
+    except Exception as e:
+        return 2
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_roblox(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occurred!")

user_scanner/social/bluesky.py

@@ -0,0 +1,71 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+import re
+import json
+
+def validate_bluesky(user):
+    handle = user if user.endswith('.bsky.social') else f"{user}.bsky.social"
+    url = "https://bsky.social/xrpc/com.atproto.temp.checkHandleAvailability"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
+        'Accept-Encoding': "gzip",
+        'atproto-accept-labelers': "did:plc:ar7c4by46qjdydhdevvrndac;redact",
+        'sec-ch-ua-platform': "\"Android\"",
+        'sec-ch-ua': "\"Google Chrome\";v=\"141\", \"Not?A_Brand\";v=\"8\", \"Chromium\";v=\"141\"",
+        'sec-ch-ua-mobile': "?1",
+        'origin': "https://bsky.app",
+        'sec-fetch-site': "cross-site",
+        'sec-fetch-mode': "cors",
+        'sec-fetch-dest': "empty",
+        'referer': "https://bsky.app/",
+        'accept-language': "en-US,en;q=0.9",
+    }
+
+    params = {
+        'handle': handle,
+    }
+
+    if not re.fullmatch(r"^[a-zA-Z0-9\.-]{1,64}$", user):
+        return 2
+
+    try:
+        response = httpx.get(url, headers=headers, params=params, timeout = 15.0)
+        status = response.status_code
+
+        if status == 200:
+            data = response.json()
+            result_type = data.get('result', {}).get('$type')
+
+            if result_type == "com.atproto.temp.checkHandleAvailability#resultAvailable":
+                return 1
+            elif result_type == "com.atproto.temp.checkHandleAvailability#resultUnavailable":
+                return 0
+            else:
+                return 2
+        else:
+            return 2
+
+    except (ConnectError, TimeoutException):
+        return 2
+    except json.JSONDecodeError:
+        return 2
+    except Exception:
+        return 2
+
+if __name__ == "__main__":
+   try:
+       import httpx
+   except ImportError:
+       print("Error: 'httpx' library is not installed.")
+       exit()
+
+   user = input ("Username?: ").strip()
+   result = validate_bluesky(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")

user_scanner/social/discord.py

@@ -0,0 +1,44 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+def validate_discord(user):
+    url = "https://discord.com/api/v9/unique-username/username-attempt-unauthed"
+
+    headers = {
+        "authority": "discord.com",
+        "accept": "/",
+        "accept-language": "en-GB,en-US;q=0.9,en;q=0.8",
+        "content-type": "application/json",
+        "origin": "https://discord.com",
+        "referer": "https://discord.com/register"
+    }
+    
+    data = {"username": user}
+    
+    try:
+        response = httpx.post(url, headers=headers, json=data, timeout=3.0)
+        if response.status_code == 200:
+            status = response.json().get("taken")
+            if status is True:
+                return 0
+            elif status is False:
+                return 1
+        return 2
+    except (ConnectError, TimeoutException):
+        return 2
+    except Exception:
+        return 2
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_discord(user)
+   
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")
+
+
+

user_scanner/social/instagram.py

@@ -13,9 +13,9 @@ def validate_instagram(user):
         'X-Requested-With': "XMLHttpRequest",
         'Referer': f"https://www.instagram.com/{user}/",
     }
-    
+
     try:
-        response = httpx.get(url, headers=headers, timeout = 15.0)
+        response = httpx.get(url, headers=headers, timeout = 3.0)
         status = response.status_code
 
         if status == 200:
@@ -31,12 +31,6 @@ def validate_instagram(user):
         return 2
 
 if __name__ == "__main__":
-   try:
-       import httpx
-   except ImportError:
-       print("Error: 'httpx' library is not installed.")
-       exit()
-
    user = input ("Username?: ").strip()
    result = validate_instagram(user)
 

user_scanner/social/mastodon.py

@@ -0,0 +1,45 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+def validate_mastodon(user):
+    url = f"https://mastodon.social/@{user}"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
+        'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
+        'Accept-Encoding': "gzip, deflate, br",
+        'Accept-Language': "en-US,en;q=0.9",
+    }
+
+    try:
+        response = httpx.get(url, headers=headers, timeout = 3.0, follow_redirects=True)
+        status = response.status_code
+
+        if status == 200:
+           return 0
+        elif status == 404:
+           return 1
+        else:
+           return 2
+
+    except (ConnectError, TimeoutException):
+        return 2
+    except Exception:
+        return 2
+
+if __name__ == "__main__":
+   try:
+       import httpx
+   except ImportError:
+       print("Error: 'httpx' library is not installed.")
+       exit()
+
+   user = input ("Username?: ").strip()
+   result = validate_mastodon(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")

user_scanner/social/pinterest.py

@@ -31,12 +31,6 @@ def validate_pinterest(user):
         return 2
 
 if __name__ == "__main__":
-   try:
-       import httpx
-   except ImportError:
-       print("Error: 'httpx' library is not installed.")
-       exit()
-
    user = input ("Username?: ").strip()
    result = validate_pinterest(user)
 

user_scanner/social/reddit.py

@@ -31,12 +31,6 @@ def validate_reddit(user):
         return 2
 
 if __name__ == "__main__":
-   try:
-       import httpx
-   except ImportError:
-       print("Error: 'httpx' library is not installed.")
-       exit()
-
    user = input ("Username?: ").strip()
    result = validate_reddit(user)
 

user_scanner/social/snapchat.py

@@ -37,12 +37,6 @@ def validate_snapchat(user):
         return 2
 
 if __name__ == "__main__":
-   try:
-       import httpx
-   except ImportError:
-       print("Error: 'httpx' library is not installed.")
-       exit()
-
    user = input ("Username?: ").strip()
    result = validate_snapchat(user)
 

user_scanner/social/telegram.py

@@ -0,0 +1,34 @@
+import httpx
+import re
+
+def validate_telegram(user: str) -> int:
+    """
+    Checks if a Telegram username is available.
+    Returns: 1 -> available, 0 -> taken, 2 -> error
+    """
+    url = f"https://t.me/{user}"
+    headers = {
+        "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36"
+    }
+
+    try:
+        r = httpx.get(url, headers=headers, follow_redirects=True, timeout=3.0)
+        if r.status_code == 200:
+            return 0 if re.search(r'<div[^>]*class="tgme_page_extra"[^>]*>', r.text) else 1
+        return 2
+    except (httpx.ConnectError, httpx.TimeoutException):
+        return 2
+    except Exception:
+        return 2
+
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_telegram(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")

user_scanner/social/threads.py

@@ -31,12 +31,6 @@ def validate_instagram(user):
         return 2
 
 if __name__ == "__main__":
-   try:
-       import httpx
-   except ImportError:
-       print("Error: 'httpx' library is not installed.")
-       exit()
-
    user = input ("Username?: ").strip()
    result = validate_instagram(user)
 

user_scanner/social/x.py

@@ -1,5 +1,6 @@
 import httpx
 import json
+from colorama import Fore, Style
 from httpx import ConnectError, TimeoutException
 
 def validate_x(user):
@@ -19,6 +20,7 @@ def validate_x(user):
     try:
         response = httpx.get(url, params=params, headers=headers, timeout = 3.0)
         status = response.status_code
+       # print(response.text)
         if status in [401, 403, 429]:
             return 2
 
@@ -29,8 +31,8 @@ def validate_x(user):
                 return 1
             elif data.get('reason') == 'taken':
                 return 0
-            elif data.get('reason') == "improper_format":
-                print(data.get('desc'))
+            elif (data.get('reason') == "improper_format" or data.get('reason') == "invalid_username"):
+                print("\n" +"  "+f"{Fore.CYAN}X says: {data.get('desc')}{Style.RESET_ALL}")
                 return 2
             else:
                 return 2
@@ -41,12 +43,6 @@ def validate_x(user):
         return 2
 
 if __name__ == "__main__":
-   try:
-       import httpx
-   except ImportError:
-       print("Error: 'httpx' library is not installed.")
-       exit()
-
    user = input ("Username?: ").strip()
    result = validate_x(user)
 

user_scanner/social/youtube.py

@@ -45,12 +45,6 @@ def validate_youtube(user):
         return 2
 
 if __name__ == "__main__":
-   try:
-       import httpx
-   except ImportError:
-       print("Error: 'httpx' library is not installed.")
-       exit()
-
    user = input ("Username?: ").strip()
    result = validate_youtube(user)
 

user_scanner/utils/version.py

@@ -0,0 +1,20 @@
+import json
+from pathlib import Path
+
+_SCRIPT_DIR = Path(__file__).resolve().parent
+VERSION_FILE = _SCRIPT_DIR.parent / "version.json"
+
+def load_local_version():
+    try:
+        data = json.loads(VERSION_FILE.read_text())
+        return data.get("version", "0.0.0"), data.get("version_type", "local")
+    except FileNotFoundError:
+        return "N/A", "file_missing"
+    except json.JSONDecodeError:
+        return "N/A", "json_error"
+    except Exception:
+        return "N/A", "error"
+
+if __name__ == "__main__":
+    version, version_type = load_local_version()
+    print(f"Version: {version}, Type: {version_type}")

user_scanner/version.json

@@ -0,0 +1,4 @@
+{
+"version": "1.0.2.0",
+"version_type": "pypi"
+}

user_scanner-1.0.2.1.dist-info/METADATA

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: user-scanner
+Version: 1.0.2.1
+Summary: Check username availability across multiple popular platforms
+Keywords: username,checker,availability,social,tech,python,user-scanner
+Author-email: Kaif <kafcodec@gmail.com>
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Requires-Dist: colorama
+Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
+
+# User Scanner
+
+![1000136215](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
+<p align="center">
+  <img src="https://img.shields.io/badge/Version-1.0.2.0-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/github/issues/kaifcodec/user-scanner?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Tested%20on-Termux-black?style=for-the-badge&logo=termux" />
+  <img src="https://img.shields.io/badge/Tested%20on-Windows-cyan?style=for-the-badge&logo=Windows" />
+  <img src="https://img.shields.io/badge/Tested%20on-Linux-balck?style=for-the-badge&logo=Linux" />
+  <img src="https://img.shields.io/pepy/dt/user-scanner?style=for-the-badge" />
+</p>
+
+---
+
+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.
+- ✅ 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
+
+```bash
+pip install user-scanner
+```
+
+---
+
+### Usage
+
+Scan a username across all platforms:
+
+```bash
+user-scanner -u <username>
+```
+Optionally, scan a specific category or single module:
+
+```bash
+user-scanner -u <username> -c dev
+user-scanner -l # Lists all available modules
+user-scanner -u <username> -m github
+
+```
+---
+### Example Output: 
+
+- Note*: New modules are constantly getting added so this might have only limited, outdated output: 
+```bash
+ Checking username: johndoe078
+
+== DEV SITES ==
+  [✔] Codeberg: Available
+  [✔] Cratesio: Available
+  [✔] Dockerhub: Available
+  [✘] Github: Taken
+  [✔] Gitlab: Available
+  [✔] Launchpad: Available
+  [✔] Npmjs: Available
+  [✔] Replit: Available
+
+== SOCIAL SITES ==
+  [✔] Bluesky: Available
+  [✔] Discord: Available
+  [✘] Instagram: Taken
+  [✔] Mastodon: Available
+  [✔] Pinterest: Available
+  [✘] Reddit: Taken
+  [✔] Snapchat: Available
+  [✔] Telegram: Available 
+  [✘] Threads: Taken
+  [✔] X (Twitter): Available
+  [✔] Youtube: Available
+
+== CREATOR SITES ==
+  [✔] Devto: Available
+  [✔] Hashnode: Available
+  [✔] Kaggle: Available
+  [✔] Medium: Available
+  [✔] Patreon: Available
+
+== COMMUNITY SITES ==
+  [✔] Coderlegion: Available
+
+== GAMING SITES ==
+  [✔] Chess_com: Available
+  [✔] Osu: Available
+  [✔] Roblox: Available
+  ...
+  ...
+  ...
+```
+### 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.)
+```
+
+**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](CONTRIBUTING.md) for examples.
+
+### 📧 Contact:
+- [Email](kaifcodec@gmail.com)
+  
+---
+
+### Dependencies: 
+- [httpx](https://pypi.org/project/httpx/)
+- [colorama](https://pypi.org/project/colorama/)
+
+---
+
+### License
+
+This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.
+
+
+<!--- 
+## 🌟 Stars: 
+
+<a href="https://www.star-history.com/#kaifcodec/user-scanner&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
+ </picture>
+</a>
+--->
+---
+## ⚠️ `community/` and `gaming/` are small, looking for contributions
+

user_scanner-1.0.2.1.dist-info/RECORD

@@ -0,0 +1,48 @@
+user_scanner/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+user_scanner/__main__.py,sha256=Zu9ZPz3f4QPvtyj9NswmUkqjQmKiFKoxOp6KKCz-ngg,3676
+user_scanner/version.json,sha256=Cg76jtg6LF1WMxx8Bh3Bsu6-Bhh0Xf3_CoSKTqU3MV8,49
+user_scanner/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/cli/banner.py,sha256=mg9yKqaK5VRvZKs7vteU1wyUlCnrmWpGC5nq9BmTGNc,1504
+user_scanner/community/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/community/coderlegion.py,sha256=wva0seSkd4h7kSjIprW0wM7JC0zspFjXGnDHkeIJ3YI,1141
+user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/core/orchestrator.py,sha256=-iP6qZQx5vN8fSZ4Z_TOxUcP9Pf3VYhsbBSQLP9ABEc,3230
+user_scanner/creator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/creator/devto.py,sha256=K9jXlwSlhJxwZomGJB7m8u_22kTejLPJ_-AvwFZahsY,1034
+user_scanner/creator/hashnode.py,sha256=2Q-K9Yuy-6qOoJJPMq3UD0JHP4d9XeO9OGpBeHuMims,1351
+user_scanner/creator/kaggle.py,sha256=pCq7QQ62wxunEmBIWNjKyWIH2ENXK76BM3zt4HWi0zM,927
+user_scanner/creator/medium.py,sha256=dWNialp0QTo4GRq64afA00G3PDXVOLZM3mnO3WnmR8c,1008
+user_scanner/creator/patreon.py,sha256=drjlB5XDFs1TW6J3W1LqBwZhc6PWtn-5nLBG8OtnFhU,1274
+user_scanner/dev/__init__.py,sha256=qUR0eLwN-gO6oKk-1cmCVT4G_AxUHHMgpV3wJ7URXi4,7
+user_scanner/dev/codeberg.py,sha256=WuGisrD2-OVolXB1T_5Dn-J8Nx5BTX_Fh2MTsK-F7os,930
+user_scanner/dev/cratesio.py,sha256=n1yJFJ2uWfRzpARSNSZ9s53iPm-5IiAxTOMTq0hOVis,999
+user_scanner/dev/dockerhub.py,sha256=P5bQEY9hm-k600rAtFi9rhiRAZy3Ansch282cC-ZTGk,1108
+user_scanner/dev/github.py,sha256=RSjJrCOchvQKYPScR2BeBn_qyUZxGyfTmNYFCOY3J7E,1407
+user_scanner/dev/gitlab.py,sha256=0-3vYg5G5_uguH2I68zZdPyq5VaMUS76766Db7uWrR8,1433
+user_scanner/dev/launchpad.py,sha256=ank50BpTsN7m5_MuQNxAbLpfQOrwjnwS_olO9nhPwgk,1074
+user_scanner/dev/npmjs.py,sha256=Tv2YgCpuSxJKWEPdcTWwm9CCl2rmfKlGdQe2rnMnXM8,1141
+user_scanner/dev/replit.py,sha256=GN1Q8PecTzBsd6TpOT-qRnMvKhFTh1P6uCa8CDlXkpw,925
+user_scanner/gaming/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/gaming/chess_com.py,sha256=QDUdijyQQi7fwy6roYWzDyAQv6gbtV-Zh_uZyHXiaR4,1505
+user_scanner/gaming/monkeytype.py,sha256=k4wgDR5lQTJBIcyeMRjPE_F5KC3kJfeAuS2eez43yAs,1665
+user_scanner/gaming/osu.py,sha256=Jz_s6qNURC-L10-MSfTh6mEywoEqOh8Stvb_bWJR_0I,1239
+user_scanner/gaming/roblox.py,sha256=eCiAEiC8BaMwcd_6k3PE30FebtsjVCBkvUTZkaaJhHY,1605
+user_scanner/social/__init__.py,sha256=jaCkFwX1uYtF0ENifVwF8OfHrYYUTm64B9wlBq9BBfQ,9
+user_scanner/social/bluesky.py,sha256=r5UIFCStlwEM4UxE6cDTrDb5w_EqPCgJ2iYz27GpjA8,2157
+user_scanner/social/discord.py,sha256=3TaYAzqK9sPKzL_GPzli4P-U22Dwe-mSmeH6kVHJXI4,1137
+user_scanner/social/instagram.py,sha256=oskZgHagkyl_p-bi7CMYqCh0wsoqfCFnR7GZcbKX1-U,1229
+user_scanner/social/mastodon.py,sha256=KbhdutPe_M0bvtkJXz2VEhalSEgA7n-bUbrkR3pYAb4,1276
+user_scanner/social/pinterest.py,sha256=LHCiTmPALPLYXDClz09EBKRREhs5u3CajeFiQg5Vvlg,1168
+user_scanner/social/reddit.py,sha256=DQYWedJeeyUuk-6EARU_52rPQHNkjfSbahOl5AHENa0,1194
+user_scanner/social/snapchat.py,sha256=ZG-SIv6RopT45dudfOm5sRxmV_ihWG1Vh1Z766fm8XE,1527
+user_scanner/social/telegram.py,sha256=QxK2jD2QEvrYmnkxysl_yk7-G6CRWvkK5EnK6n5q3jY,946
+user_scanner/social/threads.py,sha256=QRidTYquAMDHJSg68ySpWCbliRYdWJkbOqn8RfWzFQQ,1231
+user_scanner/social/x.py,sha256=NetPGmPnWEKv6za9E_Ekah9bAeeFlEeY3qbTJQo7AqE,1560
+user_scanner/social/youtube.py,sha256=zuyWCy5FtEilaIcUZ4dTCctRR9deFnwwWJkf-h_1K0E,1943
+user_scanner/utils/update.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/utils/version.py,sha256=ou6CF7ndVwEYvSpO4Se-B-71AvVezZcaZJpYFgDQsqM,621
+user_scanner-1.0.2.1.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
+user_scanner-1.0.2.1.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
+user_scanner-1.0.2.1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+user_scanner-1.0.2.1.dist-info/METADATA,sha256=AJhJys-X1IAUp3JW3UoEYcztTVYNUyRZSd5_Zu5yYHc,4970
+user_scanner-1.0.2.1.dist-info/RECORD,,

user_scanner-1.0.0.3.dist-info/METADATA

@@ -1,14 +0,0 @@
-Metadata-Version: 2.4
-Name: user-scanner
-Version: 1.0.0.3
-Summary: Check username availability across multiple popular platforms
-Keywords: username,checker,availability,social,tech,python,user-scanner
-Author-email: Kaif <kafcodec@gmail.com>
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx
-Requires-Dist: colorama
-Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
-
-# user-scanner

user_scanner-1.0.0.3.dist-info/RECORD

@@ -1,32 +0,0 @@
-user_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/__main__.py,sha256=gTuNDvGcxJxnJgbviOARUN42bhpEZ3j5oUgZBFIYa4U,3164
-user_scanner/community/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/core/orchestrator.py,sha256=5HgT9tP5r6pX8eUOaHOwXeCz0wDTfifyGW_WtNnz6kQ,3194
-user_scanner/creator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/creator/devto.py,sha256=K9jXlwSlhJxwZomGJB7m8u_22kTejLPJ_-AvwFZahsY,1034
-user_scanner/creator/hashnode.py,sha256=2Q-K9Yuy-6qOoJJPMq3UD0JHP4d9XeO9OGpBeHuMims,1351
-user_scanner/creator/kaggle.py,sha256=t5mTBz0eWZMNdy4YD1_O1wBAqHXjhmcOD0uAPzijS38,1156
-user_scanner/creator/medium.py,sha256=dWNialp0QTo4GRq64afA00G3PDXVOLZM3mnO3WnmR8c,1008
-user_scanner/dev/__init__.py,sha256=qUR0eLwN-gO6oKk-1cmCVT4G_AxUHHMgpV3wJ7URXi4,7
-user_scanner/dev/codeberg.py,sha256=WuGisrD2-OVolXB1T_5Dn-J8Nx5BTX_Fh2MTsK-F7os,930
-user_scanner/dev/cratesio.py,sha256=n1yJFJ2uWfRzpARSNSZ9s53iPm-5IiAxTOMTq0hOVis,999
-user_scanner/dev/dockerhub.py,sha256=P5bQEY9hm-k600rAtFi9rhiRAZy3Ansch282cC-ZTGk,1108
-user_scanner/dev/github.py,sha256=RSjJrCOchvQKYPScR2BeBn_qyUZxGyfTmNYFCOY3J7E,1407
-user_scanner/dev/gitlab.py,sha256=0-3vYg5G5_uguH2I68zZdPyq5VaMUS76766Db7uWrR8,1433
-user_scanner/dev/launchpad.py,sha256=ank50BpTsN7m5_MuQNxAbLpfQOrwjnwS_olO9nhPwgk,1074
-user_scanner/dev/npmjs.py,sha256=Tv2YgCpuSxJKWEPdcTWwm9CCl2rmfKlGdQe2rnMnXM8,1141
-user_scanner/dev/replit.py,sha256=GN1Q8PecTzBsd6TpOT-qRnMvKhFTh1P6uCa8CDlXkpw,925
-user_scanner/social/__init__.py,sha256=jaCkFwX1uYtF0ENifVwF8OfHrYYUTm64B9wlBq9BBfQ,9
-user_scanner/social/instagram.py,sha256=6m2TJYWSzD5cWXXBlgFRtGRY0KlqGdHFh7_mBaOQ2bg,1357
-user_scanner/social/pinterest.py,sha256=5cDmvtAXPtvpsO2vdAd30_Gx11i8L90mYrAU2OgNMQE,1291
-user_scanner/social/reddit.py,sha256=GkbQ6fPQVDygcOsnpuOkmIpATW5YlbEnKtC8lF2U5w0,1317
-user_scanner/social/snapchat.py,sha256=Qik4Jfaz3Glo_Wer5NrB7IVTBcP2D8AL_mVRnPXAKkc,1650
-user_scanner/social/threads.py,sha256=_8pUvLtJ6NT0LA9cEQn2IqIiA0IIn3LKZFaVtbhSMQk,1354
-user_scanner/social/x.py,sha256=8SfCq61ky012s1FtqQ9mcpexs3Y8z7dynmp6YgpK2gQ,1522
-user_scanner/social/youtube.py,sha256=pYBVeYpo1fFdcMAQ22ruka9TFkNpQr1h3YuatM_s0rU,2066
-user_scanner-1.0.0.3.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
-user_scanner-1.0.0.3.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
-user_scanner-1.0.0.3.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-user_scanner-1.0.0.3.dist-info/METADATA,sha256=Smt9GME2bnRFIMnbAbs34NrbttkJtU8KHqjJI28ccj8,452
-user_scanner-1.0.0.3.dist-info/RECORD,,