user-scanner 1.0.9.0__py3-none-any.whl → 1.0.10.0__py3-none-any.whl

user_scanner/__main__.py

@@ -1,6 +1,7 @@
 import argparse
 import time
 import re
+import sys
 from user_scanner.cli import printer
 from user_scanner.core.orchestrator import generate_permutations, load_categories
 from colorama import Fore, Style
@@ -8,10 +9,22 @@ from user_scanner.cli.banner import print_banner
 from typing import List
 from user_scanner.core.result import Result
 from user_scanner.core.utils import is_last_value
+from user_scanner.utils.updater_logic import check_for_updates
+from user_scanner.utils.update import update_self
+
+# Color configs
+R = Fore.RED
+G = Fore.GREEN
+C = Fore.CYAN
+Y = Fore.YELLOW
+X = Fore.RESET
+
 
 MAX_PERMUTATIONS_LIMIT = 100 # To prevent excessive generation
 
+
 def main():
+
     parser = argparse.ArgumentParser(
         prog="user-scanner",
         description="Scan usernames across multiple platforms."
@@ -51,15 +64,25 @@ def main():
     parser.add_argument(
         "-o", "--output", type=str, help="Specify the output file"
     )
+    parser.add_argument(
+        "-U", "--update", action="store_true",  help="Update user-scanner to latest version"
+    )
 
     args = parser.parse_args()
 
     Printer = printer.Printer(args.format)
 
+    if args.update is True:
+        update_self()
+        print(f"[{G}+{X}] {G}Update successful. Please restart the tool.{X}")
+        sys.exit(0)
+
     if args.list:
         Printer.print_modules(args.category)
         return
 
+    check_for_updates()
+
     if not args.username:
         parser.print_help()
         return
@@ -70,19 +93,19 @@ def main():
 
     if args.permute and args.delay == 0 and Printer.is_console:
         print(
-        Fore.YELLOW
+        Y
         + "[!] Warning: You're generating multiple usernames with NO delay between requests. "
         "This may trigger rate limits or IP bans. Use --delay 1 or higher. (Use only if the sites throw errors otherwise ignore)\n"
         + Style.RESET_ALL)
 
     usernames = [args.username]  # Default single username list
 
-    #Added permutation support , generate all possible permutation of given sequence.
+    # Added permutation support , generate all possible permutation of given sequence.
     if args.permute:
         usernames = generate_permutations(args.username, args.permute , args.stop)
         if Printer.is_console:
             print(
-                Fore.CYAN + f"[+] Generated {len(usernames)} username permutations" + Style.RESET_ALL)
+                C + f"[+] Generated {len(usernames)} username permutations" + Style.RESET_ALL)
 
     if args.module and "." in args.module:
         args.module = args.module.replace(".", "_")
@@ -118,7 +141,7 @@ def main():
                 results.extend(run_all_usernames(run_module_single, module))
         else:
             print(
-                Fore.RED + f"[!] Module '{args.module}' not found in any category." + Style.RESET_ALL)
+                R + f"[!] Module '{args.module}' not found in any category." + Style.RESET_ALL)
 
     elif args.category:
         # Category-wise scan
@@ -139,7 +162,7 @@ def main():
             "\n[!] The console format cannot be "
             f"written to file: '{args.output}'."
         )
-        print(Fore.RED + msg + Style.RESET_ALL)
+        print(R + msg + Style.RESET_ALL)
         return
 
     content = Printer.get_start()

user_scanner/cli/banner.py

@@ -1,6 +1,6 @@
 import json
 from colorama import Fore, Style, init
-from ..utils.version import load_local_version
+from ..core.version import load_local_version
 
 
 version, version_type = load_local_version()
@@ -16,18 +16,9 @@ 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__":

user_scanner/community/hackernews.py

@@ -0,0 +1,33 @@
+import re
+from user_scanner.core.orchestrator import generic_validate, Result
+
+
+def validate_hackernews(user: str) -> Result:
+    if not (2 <= len(user) <= 15):
+        return Result.error("Length must be 2-15 characters")
+
+    if not re.match(r'^[a-zA-Z0-9_-]+$', user):
+        return Result.error("Only use letters, numbers, underscores, and hyphens")
+
+    url = f"https://news.ycombinator.com/user?id={user}"
+
+    def process(response):
+        if "No such user." in response.text:
+            return Result.available()
+        if f"profile: {user}" in response.text.lower() or "created:" in response.text:
+            return Result.taken()
+        return Result.error("Unexpected response structure")
+
+    return generic_validate(url, process, timeout=3.0, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_hackernews(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner/config.json

@@ -0,0 +1 @@
+{"auto_update_status": true}

user_scanner/core/orchestrator.py

@@ -138,7 +138,7 @@ def run_checks(username: str, printer: Printer, last: bool = True) -> List[Resul
     return results
 
 
-def make_get_request(url: str, **kwargs) -> httpx.Response:
+def make_request(url: str, **kwargs) -> httpx.Response:
     """Simple wrapper to **httpx.get** that predefines headers and timeout"""
     if not "headers" in kwargs:
         kwargs["headers"] = {
@@ -152,7 +152,9 @@ def make_get_request(url: str, **kwargs) -> httpx.Response:
     if not "timeout" in kwargs:
         kwargs["timeout"] = 5.0
 
-    return httpx.get(url, **kwargs)
+    method = kwargs.pop("method", "GET")
+
+    return httpx.request(method.upper(), url, **kwargs)
 
 
 def generic_validate(url: str, func: Callable[[httpx.Response], AnyResult], **kwargs) -> AnyResult:
@@ -160,7 +162,7 @@ def generic_validate(url: str, func: Callable[[httpx.Response], AnyResult], **kw
     A generic validate function that makes a request and executes the provided function on the response.
     """
     try:
-        response = make_get_request(url, **kwargs)
+        response = make_request(url, **kwargs)
         result = func(response)
         result.url = url
         return result

user_scanner/{utils → core}/version.py

@@ -1,14 +1,15 @@
 import json
+import httpx
 from pathlib import Path
 
-_SCRIPT_DIR = Path(__file__).resolve().parent
-VERSION_FILE = _SCRIPT_DIR.parent / "version.json"
+SCRIPT_DIR = Path(__file__).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")
+        return data.get("version", "error_report_via_gh_issues"), data.get("version_type", "local")
     except FileNotFoundError:
         return "N/A", "file_missing"
     except json.JSONDecodeError:
@@ -17,6 +18,14 @@ def load_local_version():
         return "N/A", "error"
 
 
+def get_pypi_version(pypi_url):
+    try:
+        pypi_version = httpx.get(pypi_url, timeout=7).json()["info"]["version"]
+    except Exception as e:
+        print(e)
+        return None
+    return pypi_version
+
 if __name__ == "__main__":
     version, version_type = load_local_version()
     print(f"Version: {version}, Type: {version_type}")

user_scanner/creator/hashnode.py

@@ -1,5 +1,6 @@
 import httpx
 from user_scanner.core.result import Result
+from user_scanner.core.orchestrator import generic_validate
 
 
 def validate_hashnode(user):
@@ -18,9 +19,7 @@ def validate_hashnode(user):
         'Referer': "https://hashnode.com/signup",
     }
 
-    try:
-        response = httpx.post(url, json=payload, headers=headers, timeout=3.0)
-
+    def process(response):
         if response.status_code == 200:
             data = response.json()
 
@@ -35,9 +34,7 @@ def validate_hashnode(user):
         else:
             return Result.error("Invalid status code")
 
-    except Exception as e:
-        return Result.error(e)
-
+    return generic_validate(url, process, method="POST", json=payload, headers=headers, timeout=3.0)
 
 if __name__ == "__main__":
     user = input("Username?: ").strip()

user_scanner/creator/itch_io.py

@@ -1,8 +1,19 @@
-from user_scanner.core.orchestrator import status_validate
+import re
+from user_scanner.core.orchestrator import status_validate, Result
 
 
-def validate_itch_io(user):
-    url = f"https://{user}.itch.io"
+def validate_itch_io(user: str) -> Result:
+    if not (2 <= len(user) <= 25):
+        return Result.error("Length must be 2-25 characters.")
+
+    if not re.match(r'^[a-z0-9_-]+$', user):
+
+        if re.search(r'[A-Z]', user):
+            return Result.error("Use lowercase letters only.")
+
+        return Result.error("Only use lowercase letters, numbers, underscores, and hyphens.")
+
+    url = f"https://itch.io/profile/{user}"
 
     return status_validate(url, 404, 200, follow_redirects=True)
 
@@ -16,4 +27,4 @@ if __name__ == "__main__":
     elif result == 0:
         print("Unavailable!")
     else:
-        print("Error occurred!")
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner/creator/substack.py

@@ -0,0 +1,36 @@
+import re
+from user_scanner.core.orchestrator import status_validate, Result
+
+
+def validate_substack(user: str) -> Result:
+    if not (4 <= len(user) <= 32):
+        return Result.error("Length must be 4-32 characters")
+
+    if not re.match(r'^[a-z0-9]+$', user):
+        if re.search(r'[A-Z]', user):
+            return Result.error("Use lowercase letters only")
+        return Result.error("Usernames can only contain lowercase letters and numbers")
+
+    url = f"https://{user}.substack.com"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile 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': "identity",
+        'accept-language': "en-US,en;q=0.9",
+        'priority': "u=0, i"
+    }
+
+    return status_validate(url, 404, 200, headers=headers, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_substack(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner/creator/twitch.py

@@ -0,0 +1,83 @@
+import json
+import re
+import httpx
+from user_scanner.core.orchestrator import generic_validate, Result
+
+
+def validate_twitch(user: str) -> Result:
+    if not (4 <= len(user) <= 25):
+        return Result.error("Username must be between 4 and 25 characters long")
+
+    if not re.match(r"^[a-zA-Z0-9]+$", user):
+        return Result.error("Username can only contain alphanumeric characters (a-z, 0-9)")
+
+    url = "https://gql.twitch.tv/gql"
+
+    payload = [
+      {
+        "operationName": "ChannelLayout",
+        "variables": {
+          "channelLogin": user,
+          "includeIsDJ": True
+        },
+        "extensions": {
+          "persistedQuery": {
+            "version": 1,
+            "sha256Hash": "4c361fa1874dc8f6a49e62b56aa1032eccb31311bdb653918a924f96a8b2d1a6"
+          }
+        }
+      }
+    ]
+
+    headers = {
+      'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile Safari/537.36",
+      'Accept-Encoding': "identity",
+      'Content-Type': "application/json",
+      'sec-ch-ua-platform': "\"Android\"",
+      'accept-language': "en-US",
+      'client-id': "kimne78kx3ncx6brgo4mv6wki5h1ko",
+      'client-version': "7bb0442d-1175-4ab5-9d32-b1f370536cbf",
+      'origin': "https://m.twitch.tv",
+      'referer': "https://m.twitch.tv/",
+    }
+
+    def process(response: httpx.Response) -> Result:
+        if response.status_code != 200:
+            return Result.error(f"Unexpected status code: {response.status_code}")
+
+        try:
+            data = response.json()
+        except json.JSONDecodeError as e:
+            return Result.error(f"Failed to decode JSON response: {e}")
+
+        user_data = data[0].get('data', {}).get('user', {})
+        typename = user_data.get('__typename')
+
+        if typename == "User":
+            return Result.taken()
+        elif typename == "UserDoesNotExist":
+            return Result.available()
+        else:
+            return Result.error("Unexpected GraphQL response structure or type.")
+
+    return generic_validate(
+        url,
+        process,
+        headers=headers,
+        method='POST',
+        content=json.dumps(payload),
+        follow_redirects=False
+    )
+
+
+if __name__ == "__main__":
+    user = input("Twitch Username?: ").strip()
+    result = validate_twitch(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        reason = result.get_reason()
+        print(f"Error occurred! Reason: {reason}")

user_scanner/dev/bitbucket.py

@@ -0,0 +1,34 @@
+import re
+from user_scanner.core.orchestrator import status_validate, Result
+
+
+def validate_bitbucket(user: str) -> Result:
+    if not (1 <= len(user) <= 30):
+        return Result.error("Length must be 1-30 characters.")
+
+    if not re.match(r'^[a-z0-9][a-z0-9_-]*$', user):
+
+        if re.search(r'[A-Z]', user):
+            return Result.error("Use lowercase letters only.")
+
+        return Result.error("Only use lowercase letters, numbers, hyphens, and underscores.")
+
+    url = f"https://bitbucket.org/{user}/"
+
+    return status_validate(url, 404, [200, 302], follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_bitbucket(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")
+
+
+
+

user_scanner/dev/github.py

@@ -29,7 +29,7 @@ def validate_github(user):
 
         if response.status_code == 422:
             if GITHUB_INVALID_MSG in response.text:
-                return Result.error("Cannot start/end with hyphen or use double hyphens")
+                return Result.error("Cannot start/end with hyphen or use double hyphens, underscores")
 
             return Result.taken()
 

user_scanner/dev/leetcode.py

@@ -0,0 +1,35 @@
+import re
+from user_scanner.core.orchestrator import status_validate, Result
+
+
+def validate_leetcode(user: str) -> Result:
+    if not (3 <= len(user) <= 30):
+        return Result.error("Length must be between 3 and 30 characters")
+
+    if not re.match(r'^[a-zA-Z0-9._-]+$', user):
+        return Result.error("Can only use letters, numbers, underscores, periods, or hyphens")
+
+    url = f"https://leetcode.com/u/{user}/"
+
+    headers = {
+      'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile 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': "identity",
+      'upgrade-insecure-requests': "1",
+      'accept-language': "en-US,en;q=0.9",
+      'priority': "u=0, i"
+    }
+
+    return status_validate(url, 404, 200, headers=headers, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_leetcode(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner/dev/sourceforge.py

@@ -0,0 +1,30 @@
+import re
+from user_scanner.core.orchestrator import status_validate, Result
+
+
+def validate_sourceforge(user: str) -> Result:
+    if not (3 <= len(user) <= 30):
+        return Result.error("Length must be 3-30 characters.")
+
+    if not re.match(r'^[a-z0-9-]+$', user):
+
+        if re.search(r'[A-Z]', user):
+            return Result.error("Use lowercase letters only.")
+
+        return Result.error("Only use lowercase letters, numbers, and dashes.")
+
+    url = f"https://sourceforge.net/u/{user}/"
+
+    return status_validate(url, 404, 200, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_sourceforge(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner/gaming/lichess.py

@@ -0,0 +1,40 @@
+import re
+from user_scanner.core.orchestrator import generic_validate, Result
+
+
+def validate_lichess(user: str) -> Result:
+    if not (2 <= len(user) <= 20):
+        return Result.error("Length must be 2-20 characters")
+
+    if not re.match(r'^[a-zA-Z0-9_-]+$', user):
+        return Result.error("Usernames can only contain letters, numbers, underscores, and hyphens")
+
+    if re.search(r'[_-]{2,}', user):
+        return Result.error("Username cannot contain consecutive underscores or hyphens")
+
+    if not re.match(r'.*[a-zA-Z0-9]$', user):
+        return Result.error("Username must end with a letter or a number")
+
+    url = f"https://lichess.org/api/player/autocomplete?term={user}&exists=1"
+
+    def process(response):
+        res_text = response.text.strip().lower()
+        if res_text == "true":
+            return Result.taken()
+        if res_text == "false":
+            return Result.available()
+        return Result.error("Unexpected error, report it via github issues")
+
+    return generic_validate(url, process, timeout=3.0)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_lichess(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner/social/discord.py

@@ -1,5 +1,6 @@
 import httpx
 from user_scanner.core.result import Result
+from user_scanner.core.orchestrator import generic_validate
 
 def validate_discord(user):
     url = "https://discord.com/api/v9/unique-username/username-attempt-unauthed"
@@ -15,8 +16,7 @@ def validate_discord(user):
 
     data = {"username": user}
 
-    try:
-        response = httpx.post(url, headers=headers, json=data, timeout=3.0)
+    def process(response):
         if response.status_code == 200:
             status = response.json().get("taken")
             if status is True:
@@ -24,8 +24,8 @@ def validate_discord(user):
             elif status is False:
                 return Result.available()
         return Result.error("Invalid status code")
-    except Exception as e:
-        return Result.error(e)
+
+    return generic_validate(url, process, method="POST", json=data, headers=headers, timeout=3.0)
 
 
 if __name__ == "__main__":

user_scanner/utils/update.py

@@ -0,0 +1,34 @@
+import subprocess
+import sys
+from colorama import Fore
+
+def get_version(package_name):
+    try:
+        from importlib.metadata import version  # Python 3.8+
+        return version(package_name)
+    except Exception:
+        return "Unknown"
+
+def update_self():
+    print("Updating user-scanner using pip...\n")
+    try:
+        subprocess.check_call([
+            sys.executable, "-m", "pip", "uninstall", "user-scanner", "-y"
+        ])
+        subprocess.check_call([
+            sys.executable, "-m", "pip", "install", "user-scanner"
+        ])
+    except subprocess.CalledProcessError as e:
+        print(f"{Fore.RED}Failed to update user-scanner: {e}{Fore.reset}")
+        return
+
+
+    user_scanner_ver = get_version("user-scanner")
+
+    print("\nInstalled Version:")
+    print(f"   • user-scanner: {user_scanner_ver}")
+
+if __name__ == "__main__":
+    user_scanner_ver = get_version("user-scanner")
+    print(user_scanner_ver)
+

user_scanner/utils/updater_logic.py

@@ -0,0 +1,62 @@
+from pathlib import Path
+from colorama import Fore
+import sys
+import json
+from user_scanner.core.version import get_pypi_version, load_local_version
+from user_scanner.utils.update import update_self
+
+# Color configs
+R = Fore.RED
+G = Fore.GREEN
+C = Fore.CYAN
+Y = Fore.YELLOW
+X = Fore.RESET
+
+CONFIG_PATH = Path(__file__).parent.parent / "config.json"
+
+
+def load_config() -> dict:
+    if CONFIG_PATH.exists():
+        return json.loads(CONFIG_PATH.read_text())
+
+    default = {"auto_update_status": True}
+    CONFIG_PATH.write_text(json.dumps(default, indent=2))
+    return default
+
+
+def save_config_change(status: bool):
+    content = load_config()
+    content["auto_update_status"] = status
+    CONFIG_PATH.write_text(json.dumps(content, indent=2))
+
+
+def check_for_updates():
+    if not load_config().get("auto_update_status", False):
+        return
+
+    try:
+        PYPI_URL = "https://pypi.org/pypi/user-scanner/json"
+        latest_ver = get_pypi_version(PYPI_URL)
+        current_ver, _ = load_local_version()
+
+        if current_ver != latest_ver:
+            print(
+                f"\n[!] New version available: "
+                f"{R}{current_ver}{X} -> {C}{latest_ver}{X}\n"
+            )
+
+            choice = input(
+                f"{Y}Do you want to update?{X} (y/n/d: {R}don't ask again{X}): "
+            ).strip().lower()
+
+            if choice == "y":
+                update_self()
+                print(f"[{G}+{X}] {G}Update successful. Please restart the tool.{X}")
+                sys.exit(0)
+
+            elif choice == "d":
+                save_config_change(False)
+                print(f"[{Y}*{X}] {R}Auto-update checks disabled.{X}")
+
+    except Exception as e:
+        print(f"[{Y}!{X}] {R}Update check failed{X}: {e}")

user_scanner/version.json

@@ -1,4 +1,4 @@
 {
-"version": "1.0.9.0",
+"version": "1.0.10.0",
 "version_type": "pypi"
 }

{user_scanner-1.0.9.0.dist-info → user_scanner-1.0.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.9.0
+Version: 1.0.10.0
 Summary: Check username availability across multiple popular platforms
 Keywords: username,checker,availability,social,tech,python,user-scanner
 Author-email: Kaif <kafcodec@gmail.com>
@@ -13,9 +13,9 @@ Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
 
 # User Scanner
 
-![1000136215](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
+![User Scanner Logo](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
 <p align="center">
-  <img src="https://img.shields.io/badge/Version-1.0.9.0-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.10.1-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" />
@@ -32,6 +32,8 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 ### Features
 
 - ✅ Check usernames across **social networks**, **developer platforms**, and **creator communities**
+- ✅ Can be used as a username OSINT tool
+- ✅ Smart auto-update system, Detects new releases on PyPI and interactively prompts the user to upgrade.
 - ✅ Clear **Available / Taken / Error** output for each platform
 - ✅ Robust error handling: It prints the exact reason (e.g. Cannot use underscores, hyphens at the start/end)
 - ✅ Fully modular: add new platform modules easily
@@ -39,7 +41,6 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 - ✅ Selection of results format (e.g. json, csv, console (default))
 - ✅ Get the scanning results in preferred format (json/csv) in specified output file (suitable for power users)
 - ✅ 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
 ---
 
@@ -67,7 +68,7 @@ user-scanner -u <username> -m github
 ```
 
 Also, the output file and format can be specified: <br>
-\* Errors and warnings will only appear when the format is set to "console"
+
 ```bash
 user-scanner -u <username> -f console #Default format
 user-scanner -u <username> -f csv
@@ -78,7 +79,7 @@ user-scanner -u <username> -f <format> -o <output-file>
 Generate multiple username variations by appending a suffix:
 
 ```bash
-user-scanner -u <username> -p <suffix> 
+user-scanner -u <username> -p <suffix>
 ```
 Optionally, scan a specific category or single module with limit:
 
@@ -87,9 +88,20 @@ 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 (can be 0s-1s)
+```
+---
+
+### Update
+
+Update the tool to the latest PyPI version:
+
+```bash
+user-scanner -U
+
 ```
 
 ---
+
 ### Screenshot: 
 
 - Note*: New modules are constantly getting added so this might have only limited, outdated output:

{user_scanner-1.0.9.0.dist-info → user_scanner-1.0.10.0.dist-info}/RECORD

@@ -1,39 +1,48 @@
 user_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/__main__.py,sha256=jmfWuPNToix9UtLNh7IYrm-M22QBdSPtmMHv4ZY66Bc,5253
-user_scanner/version.json,sha256=dW2NfpLg6HpcgobM6wbpzkahpV6O6N2jXxTNSwuDsU4,49
+user_scanner/__main__.py,sha256=v8yb4Zcc13GmsURMtCJQ30vceeMlC8brIGQe2y5nmVs,5737
+user_scanner/config.json,sha256=WtVnrpPxhGUBmx_dBShO3R0NnipVBVz3BfzlEPO5Amc,28
+user_scanner/version.json,sha256=H8P7qm9ofNSJWEHYWmaUFTjlhwTZUsGK3m-ONOBDRmg,50
 user_scanner/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/cli/banner.py,sha256=3t6owaDArERlvpcszA1Yi3dtksvh8a9tLyrxRowTC40,1499
+user_scanner/cli/banner.py,sha256=z9gbSoJBrpGJZayJNCFzfUL-QvCZCUWyu2OEX7RZiTg,778
 user_scanner/cli/printer.py,sha256=H8rNw0ewG3G0JquKnMLW8PbHmFcALaEZZNUAsAUScHg,4027
 user_scanner/community/__init__.py,sha256=5EzlM991pJqvqIRc05_QV5BureJZ7wiCRm1AyEY6pms,12
 user_scanner/community/coderlegion.py,sha256=W_bdjzdFPRgUrNFFlylvToSJ4AzaFCtTsUy_MRVDdSo,451
+user_scanner/community/hackernews.py,sha256=lKVuEVoGnXWYSANcuUyiSHzUr-VtcXHC7sEX1rxZi0Y,1068
 user_scanner/community/stackoverflow.py,sha256=MTL8O0TLHkjVbugBh1pLxELJLU3hkX_YEHjGjaKTJi4,1007
 user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/core/orchestrator.py,sha256=BZ3IibDyT5itSdXmsTtS8SHHPT1bGwxjTwSk4xp86TU,7005
+user_scanner/core/orchestrator.py,sha256=nfe0KEcT2U_MB48OgmuvQ0tHvQdnJm8VVi06QxiuJMU,7059
 user_scanner/core/result.py,sha256=8qrIXO5jg6OjWkLtEq25lx_b1hLgtDFugdDyrJX4vcU,3300
 user_scanner/core/utils.py,sha256=v3XLUXmknf9zl_JBOmnss3280SrEWBdPcz-zq3S8lak,249
+user_scanner/core/version.py,sha256=k1_KTZdRLKBAxp8_PtOhTAtj8mBO_AUnUGdqI4epypY,855
 user_scanner/creator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/creator/devto.py,sha256=mIACmG1a4eoctywxb5p04sI0YVi3dsjCRw9YVOFBEKQ,435
-user_scanner/creator/hashnode.py,sha256=vlXsJfIG_5ShEK2xPLDl2bi6X-d08iTeoqfKeQLaB1g,1363
-user_scanner/creator/itch_io.py,sha256=JsFkFzBfJI18DeuSYJIOPGEV_9v7t-jtwmBYCA9W2P8,440
+user_scanner/creator/hashnode.py,sha256=NEIpSyf0zbcZ_QNjU3C7F5oApvVpUQOd_oQuughM-Qc,1403
+user_scanner/creator/itch_io.py,sha256=2a8UVh-_OaWQPcSUHUuijDGpWDxsR8DoCcU1BdTRqqs,854
 user_scanner/creator/kaggle.py,sha256=QaXIG02OGxvQZEvwHm50RKNd7joxGOq0Ht3cFfrYEiU,445
 user_scanner/creator/medium.py,sha256=NIOYnk8_ASD0kYfKqs8t6uZZTV4D-5-ZxyHMzOMMOuI,1015
 user_scanner/creator/patreon.py,sha256=g-r85pxirf0ihK3STyGYPIzp59MB7JH64Opb4wq1fyU,461
 user_scanner/creator/producthunt.py,sha256=p0HoIIVhmv9bBkelhfzRYudUFoyk_qeT66-hPpHEFqk,1938
+user_scanner/creator/substack.py,sha256=tisTUQmauteYZOZ0tULp9GGUuf4ZBEcpqv4ZmEvjyK0,1288
+user_scanner/creator/twitch.py,sha256=blsh5sMT7miF5-xqVXYLieTILzkop2PsWqv9HhP8G40,2509
 user_scanner/dev/__init__.py,sha256=qUR0eLwN-gO6oKk-1cmCVT4G_AxUHHMgpV3wJ7URXi4,7
+user_scanner/dev/bitbucket.py,sha256=qAIlFCmMaNTUx2-a5wJKHjbQjERcJt0zKHJmjLAeXr4,876
 user_scanner/dev/codeberg.py,sha256=Z6nV0_8xZhMiCcNn9Hn79VVh6y0ar9fqL7KS2b7IaDo,447
 user_scanner/dev/cratesio.py,sha256=mJnlLJoMLlQ7f_95QD7LgH1xCj-e6FooOFkpYypBfG4,724
 user_scanner/dev/dockerhub.py,sha256=sPEnomGiPM2mKv2HsA-9WxaXHjzz21A6ox3IXK1etLc,643
-user_scanner/dev/github.py,sha256=km0RMd4cS5sY8IUKDKoNC1oQeCj57ld4HAjOlo1w4ms,1689
+user_scanner/dev/github.py,sha256=9Q4G84WTAeWfNliApKdRFl1MJLfHvDPJ09mwr8P1ePo,1702
 user_scanner/dev/gitlab.py,sha256=kMDSd74XbofmJocfS4Fd9DxPryIHBMek3N_5c7Z_AJQ,1351
 user_scanner/dev/huggingface.py,sha256=hDanOZ45LeUg3hrN0CYrBnBnLqHCYtOWS0_HCvAbmDw,454
 user_scanner/dev/launchpad.py,sha256=N58ioX_dEHq2uwyyGrWnDKWwbqK9_RiuBQ1uWR5cDfg,799
+user_scanner/dev/leetcode.py,sha256=PTJcgp1W3fzLDK_Jy_VvRjKnLftLYMJaw3kfMjHqt9c,1246
 user_scanner/dev/npmjs.py,sha256=k-DhFqGJWDoQ79EzR8hmVrJk07AfJfPUWnIYuKc2G6w,713
 user_scanner/dev/replit.py,sha256=SI_i2l4w9tm2kBX4-cONBAT8dSynXoGEP4zcU8ngnh0,442
+user_scanner/dev/sourceforge.py,sha256=Kt8MmpCgB1tNwYRI9PYOZzIrL1VfnpzeNC43DcbZlbI,850
 user_scanner/donation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/donation/buymeacoffee.py,sha256=86LGyChv_UKQFp2D7nIoK1B-FCAAbbfabS8NA9yLp5k,459
 user_scanner/donation/liberapay.py,sha256=njClxpbRLZQ_L2-lUYCY6QFnF4IcwfCJPCIg1iEqo7M,1120
 user_scanner/gaming/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/gaming/chess_com.py,sha256=74tMgukSUXwdmD9G7Jij_gudRlSfs46Xho5KNMVeyt4,1262
+user_scanner/gaming/lichess.py,sha256=8b7DNRENh2UwjbsJNXRs2HIwC80OwGe5D0y-96_xjzs,1324
 user_scanner/gaming/minecraft.py,sha256=7a9H9ebLlRzGB0SjxLmzqLiDPDBZAuuNq3KKe2DZAvo,481
 user_scanner/gaming/monkeytype.py,sha256=n9KMBChs0ej7MgZqLGUDVz5CED70sQ3ksDF5pO0G05A,1380
 user_scanner/gaming/osu.py,sha256=2Xs1iM0CJ-3dNHu4tyF50_s0Ei_1mA5Zd6D6M5RmiVg,448
@@ -41,7 +50,7 @@ user_scanner/gaming/roblox.py,sha256=Qs51jLgKh-Ehqlco_j8CFtJ4CLVoZeBwPugDvAyLw3Q
 user_scanner/gaming/steam.py,sha256=l8xk_p9aiYQWCPoogQnO1iwkfojPhg6yd76OZHhKN50,740
 user_scanner/social/__init__.py,sha256=jaCkFwX1uYtF0ENifVwF8OfHrYYUTm64B9wlBq9BBfQ,9
 user_scanner/social/bluesky.py,sha256=11Y_vRj3txEDQqoD0iANgSWVSB8L87OotPQZquhneR0,1994
-user_scanner/social/discord.py,sha256=z-oIqT416ydnZUkq481rz6NTq5yc_BYu-P_Z79uR-Jw,1150
+user_scanner/social/discord.py,sha256=S_6ItjRcxip_L60UJ2rdLRFf4eXT7fMN7roCKA-lDfc,1193
 user_scanner/social/instagram.py,sha256=GgmKGvi3meKdZ_nQJbJSBZDJTEKSoE6Cn4_VARmo62I,953
 user_scanner/social/mastodon.py,sha256=qISx-gUsddC8lFMcmERA4N0YAnXyS1Jq2Xgg7XE4sL4,450
 user_scanner/social/pinterest.py,sha256=JIJ-HPtMoGvxW7NQzm02lChFKMmE6k6GxFoUZ6OvCec,784
@@ -52,10 +61,11 @@ user_scanner/social/telegram.py,sha256=9IS-0pghMifNRmj62NcxCOvn23Hvg0AJJcuhCa_aX
 user_scanner/social/threads.py,sha256=rK8Gm_riDdr0djo23tk38fNVVEBuC6nj2iTXvWrqXeE,951
 user_scanner/social/x.py,sha256=sAnboHHZN2DWyKeds46GLZHxGG-G_bjzfVNIkblSHx8,1406
 user_scanner/social/youtube.py,sha256=UPu584teg75P7FT05RFG3nobbHgPmzjr-ZwyN2sw6gw,1980
-user_scanner/utils/update.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/utils/version.py,sha256=mPh24EwITyXgD3AMgbflRL180pS0JfrvuJdnoErOU34,623
-user_scanner-1.0.9.0.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
-user_scanner-1.0.9.0.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
-user_scanner-1.0.9.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-user_scanner-1.0.9.0.dist-info/METADATA,sha256=IeQ-358gvD2bIm2_HgkE7SR3AIS1JQ2XgvotvzEaqpA,5772
-user_scanner-1.0.9.0.dist-info/RECORD,,
+user_scanner/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/utils/update.py,sha256=Rj3kLuUrQ-LlKGB7bkndqVjj0IUqugbDSj2SUrPRidE,936
+user_scanner/utils/updater_logic.py,sha256=Gerj6pAuv32qcfhxshWlNISRtv1X-AHFnMyssyvRbPg,1746
+user_scanner-1.0.10.0.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
+user_scanner-1.0.10.0.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
+user_scanner-1.0.10.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+user_scanner-1.0.10.0.dist-info/METADATA,sha256=8CjDUuZLzm81re81Yqy3uTIFWKYoaQC7ehjPJ_KGQqU,5907
+user_scanner-1.0.10.0.dist-info/RECORD,,