From 41e2520847aac0fc71d8bf7b136c468b53d2b84d Mon Sep 17 00:00:00 2001
From: max5010cs <max5010cs@gmail.com>
Date: Sat, 9 Aug 2025 15:08:47 -0400
Subject: [PATCH 01/19] added fuzzing logic, changed retry logic, flags added
 -r --retry; -f --fuzzy --fuzzy-all --fuzz all defaults

---
 usrlinks.log |  38 ++++++
 usrlinks.py  | 317 ++++++++++++++++++++++++++++++++++++++++++++-------
 2 files changed, 316 insertions(+), 39 deletions(-)

diff --git a/usrlinks.log b/usrlinks.log
index e69de29bb..ac2414902 100644
--- a/usrlinks.log
+++ b/usrlinks.log
@@ -0,0 +1,38 @@
+2025-08-09 11:36:55,035 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 11:36:56,194 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 11:36:58,368 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 11:37:09,627 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 11:37:25,786 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 11:37:42,899 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 11:37:59,598 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 11:38:08,239 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 11:38:10,485 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 11:38:27,329 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 11:38:43,451 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 11:39:00,607 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 11:39:16,868 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 11:39:17,990 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 11:39:20,118 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 11:39:36,583 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 11:39:52,868 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 11:40:10,019 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:04:10,932 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 12:04:12,119 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 12:04:14,290 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 12:04:22,643 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:04:38,774 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:04:56,163 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:22:15,118 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 12:22:16,300 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 12:22:18,588 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 12:22:28,770 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:22:44,938 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:23:02,084 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:34:19,813 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 12:34:21,006 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 12:34:23,171 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
+2025-08-09 12:34:32,804 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:34:52,373 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:35:10,563 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:35:32,207 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
+2025-08-09 12:47:08,380 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='github.com', port=443): Read timed out. (read timeout=15)")': /ma@x
diff --git a/usrlinks.py b/usrlinks.py
index 06f7e7f3f..4a51c5d8f 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -28,6 +28,11 @@
 from bs4 import BeautifulSoup
 from tqdm import tqdm
 import logging
+import itertools
+from rapidfuzz import fuzz
+from rich.console import Console
+from rich.table import Table as RichTable
+from rich import box
 
 # try exception block
 try:
@@ -639,9 +644,227 @@ def print_result_table(results):
     headers = ["Platform", "Status", "Profile"]
     print("\n" + Colors.CYAN + tabulate(table_data, headers=headers, tablefmt="github") + Colors.RESET)
 
+def generate_username_variants(username):
+    """Generate leet/fuzzy variants of a username."""
+    leet_map = {
+        'a': ['4', '@'], 'e': ['3'], 'i': ['1'], 'o': ['0'], 's': ['5'], 't': ['7'],
+        'A': ['4', '@'], 'E': ['3'], 'I': ['1'], 'O': ['0'], 'S': ['5'], 'T': ['7']
+    }
+    variants = set()
+
+    # leet replacements
+    def leetify(s):
+        out = set()
+        chars = list(s)
+        for i, c in enumerate(chars):
+            if c in leet_map:
+                for l in leet_map[c]:
+                    new = chars[:]
+                    new[i] = l
+                    out.add(''.join(new))
+        return out
+
+    # remove/replace underscores/dots
+    def underscore_dot_variants(s):
+        out = set()
+        if '_' in s:
+            out.add(s.replace('_', ''))
+            out.add(s.replace('_', '-'))
+        if '.' in s:
+            out.add(s.replace('.', ''))
+            out.add(s.replace('.', '-'))
+        return out
+
+    # Duplicate letters (max twice in a row)
+    def duplicate_letters(s):
+        out = set()
+        for i in range(len(s)):
+            out.add(s[:i+1] + s[i] + s[i+1:])
+        return out
+
+    # Swap adjacent letters
+    def swap_adjacent(s):
+        out = set()
+        chars = list(s)
+        for i in range(len(chars)-1):
+            swapped = chars[:]
+            swapped[i], swapped[i+1] = swapped[i+1], swapped[i]
+            out.add(''.join(swapped))
+        return out
+
+    # Append/prepend numbers
+    def add_numbers(s):
+        out = set()
+        for n in range(1, 10):
+            out.add(f"{s}{n}")
+            out.add(f"{n}{s}")
+        return out
+
+    # Collect all variants
+    variants.update(leetify(username))
+    variants.update(underscore_dot_variants(username))
+    variants.update(duplicate_letters(username))
+    variants.update(swap_adjacent(username))
+    variants.update(add_numbers(username))
+
+    # Combine some rules for more variants
+    for v in list(variants):
+        variants.update(leetify(v))
+        variants.update(underscore_dot_variants(v))
+        variants.update(duplicate_letters(v))
+        variants.update(swap_adjacent(v))
+        variants.update(add_numbers(v))
+
+    # Remove original username and deduplicate
+    variants.discard(username)
+    return list(set(variants))
+
+def run_fuzzy_scan(username, platforms, proxy=None, tor=False, threads=10, timeout=15, deep_scan=False, fuzzy_all=False):
+    console = Console()
+    variants = generate_username_variants(username)
+    if not variants:
+        console.print("[yellow][*] No variants generated for fuzzy scan.[/yellow]")
+        return
+
+    # 1. Detecting -f flag and interactive selection unless --fuzzy-all
+    selected_platforms = []
+    platform_names = list(platforms.keys())
+    if not fuzzy_all:
+        print(Colors.YELLOW + "[!] -f (fuzzy scan) detected.\n"
+              "Fuzzing will generate many username variants and check them across platforms.\n"
+              "This can take a long time because it multiplies:\n"
+              "    variants × platforms\n"
+              "Recommended: Select only 1–2 platforms to test before doing a full run.\n\n"
+              "You will:\n"
+              "  1. Choose [y/n] for each default platform.\n"
+              "  2. Optionally add custom platform URLs.\n"
+              "  3. Confirm before fuzzing starts.\n\n"
+              "Type 'ok' to continue, or 'n' to cancel." + Colors.RESET)
+        while True:
+            user_input = input("> ").strip().lower()
+            if user_input == "ok":
+                break
+            elif user_input == "n":
+                print(Colors.YELLOW + "[*] Fuzzy scan cancelled by user." + Colors.RESET)
+                return
+            else:
+                print(Colors.RED + "[!] Invalid input. Please type 'ok' to proceed or 'n' to cancel." + Colors.RESET)
+
+        # 2. Interactive default platform selection
+        for pname in platform_names:
+            while True:
+                choice = input(f"[?] Do you want to fuzz {pname}? [y/n]: ").strip().lower()
+                if choice == "y":
+                    selected_platforms.append(pname)
+                    break
+                elif choice == "n":
+                    break
+                else:
+                    print(Colors.RED + "[!] Invalid choice. Type 'y' for yes or 'n' for no." + Colors.RESET)
+
+        # 3. Optional custom URLs
+        while True:
+            custom = input("[?] Any custom platform URL to fuzz? Enter URL or 'n' for none: ").strip()
+            if custom.lower() == "n":
+                break
+            elif custom:
+                selected_platforms.append(custom)
+                while True:
+                    more = input("[?] Any more custom platforms? Enter URL or 'n' for none: ").strip()
+                    if more.lower() == "n":
+                        break
+                    elif more:
+                        selected_platforms.append(more)
+                    else:
+                        print(Colors.RED + "[!] Please enter a valid URL or 'n' for none." + Colors.RESET)
+                break
+            else:
+                print(Colors.RED + "[!] Please enter a valid URL or 'n' for none." + Colors.RESET)
+
+        # 4. Final confirmation
+        print(Colors.GREEN + "[+] Selected platforms for fuzzy scan:")
+        for p in selected_platforms:
+            print("   ", p)
+        print("\nProceed with fuzzing? [y/n]:" + Colors.RESET)
+        while True:
+            confirm = input("> ").strip().lower()
+            if confirm == "y":
+                break
+            elif confirm == "n":
+                print(Colors.YELLOW + "[*] Fuzzy scan cancelled by user." + Colors.RESET)
+                return
+            else:
+                print(Colors.RED + "[!] Invalid choice. Type 'y' for yes or 'n' for no." + Colors.RESET)
+    else:
+        selected_platforms = platform_names
+
+    # 5. Fuzzy scan execution
+    console.print("\n[bold green][*] Starting Advanced Username Fuzz Scan...[/bold green]\n")
+    results = []
+    session = get_session_with_retries(proxy, tor)
+    for platform in selected_platforms:
+        # If custom URL, use default GET logic
+        if platform in platforms:
+            info = platforms[platform]
+        else:
+            info = {"url": platform, "method": "status_code", "code": [404], "error_msg": ["404"]}
+        for variant in variants:
+            console.print(f"[cyan][+] Scanning {platform} for variant '{variant}'[/cyan]")
+            try:
+                url = info["url"].format(variant)
+                session.headers["User-Agent"] = get_random_user_agent()
+                response = session.get(url, timeout=timeout)
+                found = False
+                found_username = variant
+                if info["method"] == "status_code":
+                    if response.status_code not in info.get("code", [404]):
+                        found = True
+                elif info["method"] == "response_text":
+                    soup = BeautifulSoup(response.text, "html.parser")
+                    page_text = soup.get_text().lower()
+                    error_msgs = [msg.lower() for msg in info.get("error_msg", ["404"])]
+                    if not any(msg in page_text for msg in error_msgs):
+                        found = True
+                if found:
+                    score = fuzz.ratio(username, found_username)
+                    results.append({
+                        "platform": platform,
+                        "found_username": found_username,
+                        "similarity": score,
+                        "profile_url": url
+                    })
+            except Exception:
+                continue
+
+    # Print results table
+    if results:
+        table = RichTable(title="[bold magenta]Fuzzy Scan Results[/bold magenta]", box=box.DOUBLE_EDGE)
+        table.add_column("Platform", style="bold cyan")
+        table.add_column("Found Username", style="bold white")
+        table.add_column("Similarity", style="bold white")
+        table.add_column("Profile URL", style="bold white")
+        for r in results:
+            sim = r["similarity"]
+            if sim >= 80:
+                sim_str = f"[bold green]{sim}%[/bold green]"
+            elif sim >= 60:
+                sim_str = f"[bold yellow]{sim}%[/bold yellow]"
+            else:
+                sim_str = f"[bold red]{sim}%[/bold red]"
+            table.add_row(
+                f"[cyan]{r['platform']}[/cyan]",
+                f"[white]{r['found_username']}[/white]",
+                sim_str,
+                f"[blue]{r['profile_url']}[/blue]"
+            )
+        console.print(table)
+        console.print(f"\n[bold green][*] Fuzzy scan completed: {len(results)} matches found[/bold green]\n")
+    else:
+        console.print("[yellow][*] No fuzzy matches found.[/yellow]")
+
 def main():
     parser = argparse.ArgumentParser(description="USRLINKS - OSINT Username Hunter")
-    parser.add_argument("-u", "--username", help="Username to scan")
+    parser.add_argument("-u", "--username", help="Target username to scan", required=False)
     parser.add_argument("-p", "--proxy", help="HTTP/SOCKS proxy (e.g., http://127.0.0.1:8080)")
     parser.add_argument("-t", "--tor", action="store_true", help="Use Tor for anonymity")
     parser.add_argument("-th", "--threads", type=int, default=10, help="Number of threads (default: 10)")
@@ -650,32 +873,35 @@ def main():
     parser.add_argument("--list-platforms", action="store_true", help="List supported platforms and exit")
     parser.add_argument("--deep-scan", action="store_true", help="Perform deep reconnaissance on found profiles")
     parser.add_argument("--generate-dorks", action="store_true", help="Generate Google dorks for the username")
+    parser.add_argument("-f", "--fuzzy", action="store_true", help="Run advanced fuzzy username scan after normal scan")
+    parser.add_argument("--fuzzy-all", action="store_true", help="(Dangerous) Fuzz all platforms without prompt")
+    parser.add_argument("-r", "--retry", action="store_true", help="Retry failed requests after normal scan")
     
     args = parser.parse_args()
     platforms = load_platforms(args.platforms)
-    
+
     if args.list_platforms:
         list_platforms(platforms)
         sys.exit(0)
-    
+
     if args.generate_dorks:
         if not args.username:
             print(Colors.RED + "[-] Username required for dork generation")
             sys.exit(1)
         generate_dorks(args.username)
         sys.exit(0)
-    
+
     if not args.username:
         parser.print_help()
         sys.exit(1)
-    
+
     display_banner()
-    
+
     if args.deep_scan:
         print(Colors.YELLOW + f"[*] Deep scanning enabled - extracting profile information...\n")
-    
+
     print(Colors.YELLOW + f"[*] Scanning for username: {args.username}...\n")
-    
+
     results = scan_usernames(
         username=args.username,
         platforms=platforms,
@@ -684,45 +910,58 @@ def main():
         threads=args.threads,
         deep_scan=args.deep_scan
     )
-    
-    print_result_table(results)  # show initial results table
 
-    # retry failed platforms 2 times again
-    failed_results = [r for r in results if r["available"] is None]
-    session = get_session_with_retries(args.proxy, args.tor)
-    if failed_results:
-        from tqdm import tqdm
-        for attempt in range(2):
-            tqdm.write(f"\n[⏳] Retrying failed platforms (Attempt {attempt + 1}/2)")
-            retry_results = []
-            for fr in failed_results:
-                tqdm.write(f"[•] Retrying {fr['platform']}...")
-                retry_result = check_platform(session, args.username, fr['platform'], platforms[fr['platform']], timeout=15)
-                retry_results.append(retry_result)
-
-                if retry_result["available"] is True:
-                    tqdm.write(f"[✓] {fr['platform']}: Available")
-                elif retry_result["available"] is False:
-                    tqdm.write(f"[✗] {fr['platform']}: Taken")
-                else:
-                    tqdm.write(f"[!] {fr['platform']}: Still error")
-
-            print_result_table(retry_results)
-            failed_results = [r for r in retry_results if r["available"] is None]
-
-            if not failed_results:
-                tqdm.write("[✓] All platforms resolved after retries.")
-                break
+    print_result_table(results)  # show initial results table
 
+    # Only retry if --retry is passed
+    if args.retry:
+        failed_results = [r for r in results if r["available"] is None]
+        session = get_session_with_retries(args.proxy, args.tor)
         if failed_results:
-            failed_names = [r["platform"] for r in failed_results]
-            tqdm.write(f"[*] Still failing after 2 retries: {failed_names}")
+            from tqdm import tqdm
+            for attempt in range(2):
+                tqdm.write(f"\n[⏳] Retrying failed platforms (Attempt {attempt + 1}/2)")
+                retry_results = []
+                for fr in failed_results:
+                    tqdm.write(f"[•] Retrying {fr['platform']}...")
+                    retry_result = check_platform(session, args.username, fr['platform'], platforms[fr['platform']], timeout=15)
+                    retry_results.append(retry_result)
+
+                    if retry_result["available"] is True:
+                        tqdm.write(f"[✓] {fr['platform']}: Available")
+                    elif retry_result["available"] is False:
+                        tqdm.write(f"[✗] {fr['platform']}: Taken")
+                    else:
+                        tqdm.write(f"[!] {fr['platform']}: Still error")
+
+                print_result_table(retry_results)
+                failed_results = [r for r in retry_results if r["available"] is None]
+
+                if not failed_results:
+                    tqdm.write("[✓] All platforms resolved after retries.")
+                    break
+
+            if failed_results:
+                failed_names = [r["platform"] for r in failed_results]
+                tqdm.write(f"[*] Still failing after 2 retries: {failed_names}")
 
     display_results(results, args.username, args.deep_scan)
-    
+
     if args.output:
         save_results(results, args.username, args.output)
 
+    # Fuzzy scan last if requested
+    if args.fuzzy:
+        run_fuzzy_scan(
+            username=args.username,
+            platforms=platforms,
+            proxy=args.proxy,
+            tor=args.tor,
+            threads=args.threads,
+            deep_scan=args.deep_scan,
+            fuzzy_all=getattr(args, "fuzzy_all", False)
+        )
+
 if __name__ == "__main__":
     try:
         main()

From 9b4bd2c113ee4b65f349a54d40b6c2b76c00ec68 Mon Sep 17 00:00:00 2001
From: max5010cs <max5010cs@gmail.com>
Date: Sun, 10 Aug 2025 00:40:17 -0400
Subject: [PATCH 02/19] last issue upgrade: metadata extraction

---
 usrlinks.log |  30 +++++++
 usrlinks.py  | 224 ++++++++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 252 insertions(+), 2 deletions(-)

diff --git a/usrlinks.log b/usrlinks.log
index ac2414902..7c2e4dfb1 100644
--- a/usrlinks.log
+++ b/usrlinks.log
@@ -36,3 +36,33 @@
 2025-08-09 12:35:10,563 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
 2025-08-09 12:35:32,207 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
 2025-08-09 12:47:08,380 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='github.com', port=443): Read timed out. (read timeout=15)")': /ma@x
+2025-08-10 00:11:10,968 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:11:12,148 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:11:14,320 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:11:24,695 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:11:40,853 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:11:58,165 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:17:38,799 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:17:39,998 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:17:42,224 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:17:53,304 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:18:09,497 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:18:26,779 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:23:40,359 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:23:41,553 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:23:43,779 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:23:49,336 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:24:05,499 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:24:22,651 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:25:48,310 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:25:49,484 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:25:50,746 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, '[SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1029)'))': /@stilla1ex
+2025-08-10 00:26:06,630 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='soundcloud.com', port=443): Read timed out. (read timeout=15)")': /stilla1ex
+2025-08-10 00:26:06,885 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:26:24,159 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:32:19,768 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:32:21,534 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:32:23,711 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
+2025-08-10 00:32:33,127 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:32:49,318 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
+2025-08-10 00:33:06,474 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
diff --git a/usrlinks.py b/usrlinks.py
index 4a51c5d8f..a178fe887 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -33,6 +33,8 @@
 from rich.console import Console
 from rich.table import Table as RichTable
 from rich import box
+import asyncio
+import aiohttp
 
 # try exception block
 try:
@@ -794,7 +796,7 @@ def run_fuzzy_scan(username, platforms, proxy=None, tor=False, threads=10, timeo
                 print(Colors.YELLOW + "[*] Fuzzy scan cancelled by user." + Colors.RESET)
                 return
             else:
-                print(Colors.RED + "[!] Invalid choice. Type 'y' for yes or 'n' for no." + Colors.RESET)
+                print(Colors.RED + "[!] Invalid choice. Type 'y' for yes or 'n' to cancel." + Colors.RESET)
     else:
         selected_platforms = platform_names
 
@@ -862,6 +864,218 @@ def run_fuzzy_scan(username, platforms, proxy=None, tor=False, threads=10, timeo
     else:
         console.print("[yellow][*] No fuzzy matches found.[/yellow]")
 
+def parse_metadata_github(soup):
+    return {
+        "display_name": soup.find("span", {"itemprop": "name"}).get_text(strip=True) if soup.find("span", {"itemprop": "name"}) else "N/A",
+        "bio": soup.find("div", class_="user-profile-bio").get_text(strip=True) if soup.find("div", class_="user-profile-bio") else "N/A",
+        "location": soup.find("li", {"itemprop": "homeLocation"}).get_text(strip=True) if soup.find("li", {"itemprop": "homeLocation"}) else "N/A",
+        "followers": soup.find("a", href=lambda x: x and x.endswith("?tab=followers")).get_text(strip=True) if soup.find("a", href=lambda x: x and x.endswith("?tab=followers")) else "N/A",
+        "following": soup.find("a", href=lambda x: x and x.endswith("?tab=following")).get_text(strip=True) if soup.find("a", href=lambda x: x and x.endswith("?tab=following")) else "N/A",
+        "posts": "N/A",
+        "profile_image_url": soup.find("img", class_="avatar-user")["src"] if soup.find("img", class_="avatar-user") else "N/A",
+        "joined_date": soup.find("div", class_="js-profile-editable-area").find("div", class_="p-note user-profile-bio mb-3 js-user-profile-bio f4").get_text(strip=True) if soup.find("div", class_="js-profile-editable-area") and soup.find("div", class_="js-profile-editable-area").find("div", class_="p-note user-profile-bio mb-3 js-user-profile-bio f4") else "N/A",
+        "verified_status": "N/A"
+    }
+
+def parse_metadata_twitter(soup):
+    return {
+        "display_name": soup.find("div", {"data-testid": "UserName"}).get_text(strip=True) if soup.find("div", {"data-testid": "UserName"}) else "N/A",
+        "bio": soup.find("div", {"data-testid": "UserDescription"}).get_text(strip=True) if soup.find("div", {"data-testid": "UserDescription"}) else "N/A",
+        "location": soup.find("span", {"data-testid": "UserLocation"}).get_text(strip=True) if soup.find("span", {"data-testid": "UserLocation"}) else "N/A",
+        "followers": soup.find("a", href=lambda x: x and "/followers" in x).get_text(strip=True) if soup.find("a", href=lambda x: x and "/followers" in x) else "N/A",
+        "following": soup.find("a", href=lambda x: x and "/following" in x).get_text(strip=True) if soup.find("a", href=lambda x: x and "/following" in x) else "N/A",
+        "posts": "N/A",
+        "profile_image_url": soup.find("img", {"alt": "Image"}).get("src") if soup.find("img", {"alt": "Image"}) else "N/A",
+        "joined_date": soup.find("span", string=lambda x: x and "Joined" in x).get_text(strip=True) if soup.find("span", string=lambda x: x and "Joined" in x) else "N/A",
+        "verified_status": "Yes" if soup.find("svg", {"data-testid": "verificationBadge"}) else "No"
+    }
+
+def parse_metadata_instagram(soup):
+    meta = lambda prop: soup.find("meta", property=prop)
+    return {
+        "display_name": meta("og:title")["content"] if meta("og:title") else "N/A",
+        "bio": meta("og:description")["content"] if meta("og:description") else "N/A",
+        "location": "N/A",
+        "followers": "N/A",
+        "following": "N/A",
+        "posts": "N/A",
+        "profile_image_url": meta("og:image")["content"] if meta("og:image") else "N/A",
+        "joined_date": "N/A",
+        "verified_status": "N/A"
+    }
+
+def parse_metadata_default(soup):
+    return {
+        "display_name": "N/A",
+        "bio": "N/A",
+        "location": "N/A",
+        "followers": "N/A",
+        "following": "N/A",
+        "posts": "N/A",
+        "profile_image_url": "N/A",
+        "joined_date": "N/A",
+        "verified_status": "N/A"
+    }
+
+PLATFORM_METADATA_PARSERS = {
+    "GitHub": parse_metadata_github,
+    "Twitter": parse_metadata_twitter,
+    "Instagram": parse_metadata_instagram,
+}
+
+async def fetch_metadata(session, platform, url):
+    try:
+        headers = {"User-Agent": get_random_user_agent()}
+        async with session.get(url, timeout=15, headers=headers) as resp:
+            html = await resp.text()
+            soup = BeautifulSoup(html, "html.parser")
+            parser = PLATFORM_METADATA_PARSERS.get(platform, parse_metadata_default)
+            meta = parser(soup)
+            return (platform, meta)
+    except Exception:
+        return (platform, None)
+
+async def extract_metadata_async(platform_url_pairs, concurrency=3):
+    results = []
+    sem = asyncio.Semaphore(concurrency)
+    async with aiohttp.ClientSession() as session:
+        async def sem_fetch(platform, url):
+            async with sem:
+                return await fetch_metadata(session, platform, url)
+        tasks = [sem_fetch(platform, url) for platform, url in platform_url_pairs]
+        for coro in asyncio.as_completed(tasks):
+            result = await coro
+            results.append(result)
+    return results
+
+def display_metadata_table(meta_results):
+    """
+    Display metadata extraction results in a clean vertical table per account.
+    Each account/platform is shown as a block with field/value pairs.
+    """
+    console = Console()
+    if not meta_results:
+        console.print("[yellow][*] No metadata results to display.[/yellow]")
+        return
+
+    for platform, meta in meta_results:
+        console.print(f"\n[bold magenta]Platform:[/bold magenta] [cyan]{platform}[/cyan]")
+        if meta is None:
+            console.print("[red]  [-] Failed to retrieve metadata[/red]")
+            continue
+        table = RichTable(show_header=False, box=box.SIMPLE, expand=False, padding=(0,1))
+        table.add_row("[bold]Display Name[/bold]", meta.get("display_name", "N/A"))
+        table.add_row("[bold]Bio[/bold]", meta.get("bio", "N/A"))
+        table.add_row("[bold]Location[/bold]", meta.get("location", "N/A"))
+        table.add_row("[bold]Followers[/bold]", meta.get("followers", "N/A"))
+        table.add_row("[bold]Following[/bold]", meta.get("following", "N/A"))
+        table.add_row("[bold]Posts[/bold]", meta.get("posts", "N/A"))
+        table.add_row("[bold]Joined[/bold]", meta.get("joined_date", "N/A"))
+        table.add_row("[bold]Verified[/bold]", meta.get("verified_status", "N/A"))
+        table.add_row("[bold]Profile Image URL[/bold]", meta.get("profile_image_url", "N/A"))
+        console.print(table)
+    print()  # Extra newline after all blocks
+
+def prompt_custom_urls():
+    urls = []
+    while True:
+        custom = input("[?] Add custom platform URL to check? Enter URL or 'n' for none: ").strip()
+        if custom.lower() == "n":
+            break
+        elif custom:
+            urls.append(custom)
+        else:
+            print(Colors.RED + "[!] Please enter a valid URL or 'n' for none." + Colors.RESET)
+    return urls
+
+def prompt_platform_selection(platforms):
+    selected = []
+    for p in platforms:
+        while True:
+            ans = input(f"Extract metadata from {p}? [y/n]: ").strip().lower()
+            if ans == "y":
+                selected.append(p)
+                break
+            elif ans == "n":
+                break
+            else:
+                print(Colors.RED + "[!] Invalid choice. Type 'y' for yes or 'n' for no." + Colors.RESET)
+    return selected
+
+def run_metadata_extraction(confirmed_hits, platforms):
+    count = len(confirmed_hits)
+    platform_url_pairs = [(p, url) for p, url in confirmed_hits.items()]
+    # Interactive logic
+    if count <= 5:
+        print(Colors.GREEN + f"[+] Metadata extraction detected for up to {count} platforms." + Colors.RESET)
+        ans = input("Do you want to add extra custom platform URL(s) to check? [y/n]: ").strip().lower()
+        custom_urls = []
+        if ans == "y":
+            custom_urls = prompt_custom_urls()
+        for url in custom_urls:
+            platform_url_pairs.append((url, url))
+    else:
+        print(Colors.YELLOW + "[-] Metadata extraction may take extra time depending on platform speed and rate limits." + Colors.RESET)
+        ans = input("Proceed with all platforms? [y/n]: ").strip().lower()
+        if ans == "y":
+            pass  # use all
+        else:
+            selected = prompt_platform_selection(list(confirmed_hits.keys()))
+            platform_url_pairs = [(p, confirmed_hits[p]) for p in selected]
+            custom_urls = prompt_custom_urls()
+            for url in custom_urls:
+                platform_url_pairs.append((url, url))
+    print(Colors.MAGENTA + "\n[+] Starting metadata extraction...\n" + Colors.RESET)
+    # Run asyncio event loop for metadata extraction
+    loop = asyncio.get_event_loop()
+    meta_results = loop.run_until_complete(extract_metadata_async(platform_url_pairs))
+    display_metadata_table(meta_results)
+
+def run_metadata_extraction_interactive(confirmed_hits, platforms):
+    count = len(confirmed_hits)
+    platform_url_pairs = []
+    custom_urls = []
+
+    if count == 0:
+        print(Colors.YELLOW + "[*] No confirmed accounts to extract metadata from." + Colors.RESET)
+        return
+
+    if count <= 5:
+        print(Colors.GREEN + f"[+] Metadata extraction detected for up to {count} platforms." + Colors.RESET)
+        while True:
+            ans = input("Do you want to add extra custom platform URL(s) to check? [y/n]: ").strip().lower()
+            if ans == "y":
+                custom_urls = prompt_custom_urls()
+                break
+            elif ans == "n":
+                break
+            else:
+                print(Colors.RED + "[!] Invalid choice. Type 'y' for yes or 'n' to cancel." + Colors.RESET)
+        platform_url_pairs = [(p, url) for p, url in confirmed_hits.items()]
+        for url in custom_urls:
+            platform_url_pairs.append((url, url))
+    else:
+        print(Colors.YELLOW + "[-] Metadata extraction may take extra time depending on platform speed and rate limits." + Colors.RESET)
+        while True:
+            ans = input("Proceed with all platforms? [y/n]: ").strip().lower()
+            if ans == "y":
+                platform_url_pairs = [(p, url) for p, url in confirmed_hits.items()]
+                break
+            elif ans == "n":
+                selected = prompt_platform_selection(list(confirmed_hits.keys()))
+                platform_url_pairs = [(p, confirmed_hits[p]) for p in selected]
+                custom_urls = prompt_custom_urls()
+                for url in custom_urls:
+                    platform_url_pairs.append((url, url))
+                break
+            else:
+                print(Colors.RED + "[!] Invalid choice. Type 'y' for yes or 'n' to cancel." + Colors.RESET)
+
+    print(Colors.MAGENTA + "\n[+] Starting metadata extraction...\n" + Colors.RESET)
+    loop = asyncio.get_event_loop()
+    meta_results = loop.run_until_complete(extract_metadata_async(platform_url_pairs))
+    display_metadata_table(meta_results)
+
 def main():
     parser = argparse.ArgumentParser(description="USRLINKS - OSINT Username Hunter")
     parser.add_argument("-u", "--username", help="Target username to scan", required=False)
@@ -876,7 +1090,8 @@ def main():
     parser.add_argument("-f", "--fuzzy", action="store_true", help="Run advanced fuzzy username scan after normal scan")
     parser.add_argument("--fuzzy-all", action="store_true", help="(Dangerous) Fuzz all platforms without prompt")
     parser.add_argument("-r", "--retry", action="store_true", help="Retry failed requests after normal scan")
-    
+    parser.add_argument("-m", "--metadata", action="store_true", help="Enable profile metadata extraction for confirmed accounts after scan.")
+
     args = parser.parse_args()
     platforms = load_platforms(args.platforms)
 
@@ -950,6 +1165,11 @@ def main():
     if args.output:
         save_results(results, args.username, args.output)
 
+    # Metadata extraction logic (interactive, after showing results)
+    if getattr(args, "metadata", False):
+        confirmed_hits = {r["platform"]: r["url"] for r in results if r["available"] is False}
+        run_metadata_extraction_interactive(confirmed_hits, platforms)
+
     # Fuzzy scan last if requested
     if args.fuzzy:
         run_fuzzy_scan(

From e8b4e8f74396a0c80f4cbe311b19565737a56ec4 Mon Sep 17 00:00:00 2001
From: max5010cs <max5010cs@gmail.com>
Date: Mon, 11 Aug 2025 02:47:09 -0400
Subject: [PATCH 03/19] Update usrlinks.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 usrlinks.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/usrlinks.py b/usrlinks.py
index a178fe887..152bfa3df 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -1078,7 +1078,7 @@ def run_metadata_extraction_interactive(confirmed_hits, platforms):
 
 def main():
     parser = argparse.ArgumentParser(description="USRLINKS - OSINT Username Hunter")
-    parser.add_argument("-u", "--username", help="Target username to scan", required=False)
+    parser.add_argument("-u", "--username", help="Target username to scan", required=True)
     parser.add_argument("-p", "--proxy", help="HTTP/SOCKS proxy (e.g., http://127.0.0.1:8080)")
     parser.add_argument("-t", "--tor", action="store_true", help="Use Tor for anonymity")
     parser.add_argument("-th", "--threads", type=int, default=10, help="Number of threads (default: 10)")

From cdc0df3ea98c930f6009e6d8390400c86f5be7d6 Mon Sep 17 00:00:00 2001
From: max5010cs <max5010cs@gmail.com>
Date: Mon, 11 Aug 2025 02:47:22 -0400
Subject: [PATCH 04/19] Update usrlinks.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 usrlinks.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/usrlinks.py b/usrlinks.py
index 152bfa3df..5a2cf0142 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -1167,7 +1167,7 @@ def main():
 
     # Metadata extraction logic (interactive, after showing results)
     if getattr(args, "metadata", False):
-        confirmed_hits = {r["platform"]: r["url"] for r in results if r["available"] is False}
+        confirmed_hits = {r["platform"]: r["url"] for r in results if r["available"] is False or (r["available"] is None and r.get("url"))}
         run_metadata_extraction_interactive(confirmed_hits, platforms)
 
     # Fuzzy scan last if requested

From e69559ef57ea48490b069865ed060ad25b9a9096 Mon Sep 17 00:00:00 2001
From: max5010cs <max5010cs@gmail.com>
Date: Mon, 11 Aug 2025 02:47:37 -0400
Subject: [PATCH 05/19] Update usrlinks.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 usrlinks.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/usrlinks.py b/usrlinks.py
index 5a2cf0142..9a9050305 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -1028,7 +1028,7 @@ def run_metadata_extraction(confirmed_hits, platforms):
     print(Colors.MAGENTA + "\n[+] Starting metadata extraction...\n" + Colors.RESET)
     # Run asyncio event loop for metadata extraction
     loop = asyncio.get_event_loop()
-    meta_results = loop.run_until_complete(extract_metadata_async(platform_url_pairs))
+    meta_results = asyncio.run(extract_metadata_async(platform_url_pairs))
     display_metadata_table(meta_results)
 
 def run_metadata_extraction_interactive(confirmed_hits, platforms):

From 653d0a144f1f0a5dd2cf008bd813b76058817a55 Mon Sep 17 00:00:00 2001
From: max5010cs <max5010cs@gmail.com>
Date: Mon, 11 Aug 2025 02:47:54 -0400
Subject: [PATCH 06/19] Update usrlinks.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 usrlinks.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/usrlinks.py b/usrlinks.py
index 9a9050305..0a024b064 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -1073,7 +1073,7 @@ def run_metadata_extraction_interactive(confirmed_hits, platforms):
 
     print(Colors.MAGENTA + "\n[+] Starting metadata extraction...\n" + Colors.RESET)
     loop = asyncio.get_event_loop()
-    meta_results = loop.run_until_complete(extract_metadata_async(platform_url_pairs))
+    meta_results = asyncio.run(extract_metadata_async(platform_url_pairs))
     display_metadata_table(meta_results)
 
 def main():

From 20b3707ff536358d29c2595f7997f3db6d9bcbd6 Mon Sep 17 00:00:00 2001
From: max5010cs <max5010cs@gmail.com>
Date: Mon, 11 Aug 2025 02:48:04 -0400
Subject: [PATCH 07/19] Update usrlinks.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 usrlinks.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/usrlinks.py b/usrlinks.py
index 0a024b064..4450d1e6c 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -873,7 +873,7 @@ def parse_metadata_github(soup):
         "following": soup.find("a", href=lambda x: x and x.endswith("?tab=following")).get_text(strip=True) if soup.find("a", href=lambda x: x and x.endswith("?tab=following")) else "N/A",
         "posts": "N/A",
         "profile_image_url": soup.find("img", class_="avatar-user")["src"] if soup.find("img", class_="avatar-user") else "N/A",
-        "joined_date": soup.find("div", class_="js-profile-editable-area").find("div", class_="p-note user-profile-bio mb-3 js-user-profile-bio f4").get_text(strip=True) if soup.find("div", class_="js-profile-editable-area") and soup.find("div", class_="js-profile-editable-area").find("div", class_="p-note user-profile-bio mb-3 js-user-profile-bio f4") else "N/A",
+        "joined_date": soup.find("li", {"itemprop": "dateJoined"}).get_text(strip=True) if soup.find("li", {"itemprop": "dateJoined"}) else "N/A",
         "verified_status": "N/A"
     }
 

From 92fb16b4533231c630d82a43e90ceb951d5c1bfe Mon Sep 17 00:00:00 2001
From: max5010cs <max5010cs@gmail.com>
Date: Mon, 11 Aug 2025 02:48:21 -0400
Subject: [PATCH 08/19] Update usrlinks.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 usrlinks.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/usrlinks.py b/usrlinks.py
index 4450d1e6c..5bd9e6da0 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -1030,7 +1030,7 @@ def run_metadata_extraction(confirmed_hits, platforms):
     loop = asyncio.get_event_loop()
     meta_results = asyncio.run(extract_metadata_async(platform_url_pairs))
     display_metadata_table(meta_results)
-
+# (Function run_metadata_extraction removed as it was unused and duplicated logic.)
 def run_metadata_extraction_interactive(confirmed_hits, platforms):
     count = len(confirmed_hits)
     platform_url_pairs = []

From 91b938d5597831bbb6053bbc70d2cf6d19688f91 Mon Sep 17 00:00:00 2001
From: max5010cs <max5010cs@gmail.com>
Date: Mon, 11 Aug 2025 02:48:47 -0400
Subject: [PATCH 09/19] Update usrlinks.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 usrlinks.py | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/usrlinks.py b/usrlinks.py
index 5bd9e6da0..6075c422f 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -719,7 +719,29 @@ def add_numbers(s):
 
     # Remove original username and deduplicate
     variants.discard(username)
-    return list(set(variants))
+    # Start with initial username
+    queue.append(username)
+    seen = set([username])
+
+    # Apply transformations breadth-first, limit depth to avoid exponential blowup
+    max_depth = 2
+    depth = 0
+    while queue and depth < max_depth:
+        next_queue = deque()
+        while queue:
+            current = queue.popleft()
+            for func in (leetify, underscore_dot_variants, duplicate_letters, swap_adjacent, add_numbers):
+                for v in func(current):
+                    if v not in seen:
+                        variants.add(v)
+                        next_queue.append(v)
+                        seen.add(v)
+        queue = next_queue
+        depth += 1
+
+    # Remove original username and deduplicate
+    variants.discard(username)
+    return list(variants)
 
 def run_fuzzy_scan(username, platforms, proxy=None, tor=False, threads=10, timeout=15, deep_scan=False, fuzzy_all=False):
     console = Console()

From f2cedd669ac09c9e2f1d9f97b1da36a3d395f09c Mon Sep 17 00:00:00 2001
From: stilla1ex <alexmwangimungai254@gmail.com>
Date: Mon, 11 Aug 2025 03:17:14 -0400
Subject: [PATCH 10/19] Minor changes

---
 USRLINKS_alex_20250811_025741.json | 212 +++++++++++++++++++++++++++++
 requirements.txt                   |   5 +-
 2 files changed, 216 insertions(+), 1 deletion(-)
 create mode 100644 USRLINKS_alex_20250811_025741.json

diff --git a/USRLINKS_alex_20250811_025741.json b/USRLINKS_alex_20250811_025741.json
new file mode 100644
index 000000000..e69fb3651
--- /dev/null
+++ b/USRLINKS_alex_20250811_025741.json
@@ -0,0 +1,212 @@
+[
+  {
+    "platform": "Twitter",
+    "url": "https://twitter.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "TikTok",
+    "url": "https://tiktok.com/@alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Reddit",
+    "url": "https://reddit.com/user/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Pinterest",
+    "url": "https://pinterest.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Instagram",
+    "url": "https://instagram.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "YouTube",
+    "url": "https://youtube.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Facebook",
+    "url": "https://facebook.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "LinkedIn",
+    "url": "https://linkedin.com/in/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Steam",
+    "url": "https://steamcommunity.com/id/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Medium",
+    "url": "https://medium.com/@alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Twitch",
+    "url": "https://twitch.tv/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Vimeo",
+    "url": "https://vimeo.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "GitHub",
+    "url": "https://github.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "SoundCloud",
+    "url": "https://soundcloud.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "DeviantArt",
+    "url": "https://alex.deviantart.com",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Last.fm",
+    "url": "https://last.fm/user/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "CodePen",
+    "url": "https://codepen.io/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Bitbucket",
+    "url": "https://bitbucket.org/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Telegram",
+    "url": "https://t.me/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Tumblr",
+    "url": "https://alex.tumblr.com",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Keybase",
+    "url": "https://keybase.io/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "HackerNews",
+    "url": "https://news.ycombinator.com/user?id=alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "GitLab",
+    "url": "https://gitlab.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Spotify",
+    "url": "https://open.spotify.com/user/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Quora",
+    "url": "https://www.quora.com/profile/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Roblox",
+    "url": "https://www.roblox.com/user.aspx?username=alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "VK",
+    "url": "https://vk.com/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Pastebin",
+    "url": "https://pastebin.com/u/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Imgur",
+    "url": "https://imgur.com/user/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  },
+  {
+    "platform": "Etsy",
+    "url": "https://www.etsy.com/shop/alex",
+    "available": null,
+    "recon_data": {},
+    "error": "Missing dependencies for SOCKS support."
+  }
+]
\ No newline at end of file
diff --git a/requirements.txt b/requirements.txt
index 3924d0579..f556cf657 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,4 +3,7 @@ beautifulsoup4
 fake_useragent
 tqdm
 dnspython
-tabulate  # used for summary tables
\ No newline at end of file
+tabulate  # used for summary tables
+rapidfuzz  # for fuzzy string matching
+rich       # for enhanced console output
+aiohttp    # for asynchronous HTTP requests
\ No newline at end of file

From e6bc9b61ec095062254326e6be5ecc5ade4791e6 Mon Sep 17 00:00:00 2001
From: stilla1ex <alexmwangimungai254@gmail.com>
Date: Mon, 11 Aug 2025 03:18:50 -0400
Subject: [PATCH 11/19] Minor changes

---
 USRLINKS_alex_20250811_025741.json | 212 -----------------------------
 1 file changed, 212 deletions(-)
 delete mode 100644 USRLINKS_alex_20250811_025741.json

diff --git a/USRLINKS_alex_20250811_025741.json b/USRLINKS_alex_20250811_025741.json
deleted file mode 100644
index e69fb3651..000000000
--- a/USRLINKS_alex_20250811_025741.json
+++ /dev/null
@@ -1,212 +0,0 @@
-[
-  {
-    "platform": "Twitter",
-    "url": "https://twitter.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "TikTok",
-    "url": "https://tiktok.com/@alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Reddit",
-    "url": "https://reddit.com/user/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Pinterest",
-    "url": "https://pinterest.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Instagram",
-    "url": "https://instagram.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "YouTube",
-    "url": "https://youtube.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Facebook",
-    "url": "https://facebook.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "LinkedIn",
-    "url": "https://linkedin.com/in/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Steam",
-    "url": "https://steamcommunity.com/id/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Medium",
-    "url": "https://medium.com/@alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Twitch",
-    "url": "https://twitch.tv/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Vimeo",
-    "url": "https://vimeo.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "GitHub",
-    "url": "https://github.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "SoundCloud",
-    "url": "https://soundcloud.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "DeviantArt",
-    "url": "https://alex.deviantart.com",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Last.fm",
-    "url": "https://last.fm/user/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "CodePen",
-    "url": "https://codepen.io/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Bitbucket",
-    "url": "https://bitbucket.org/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Telegram",
-    "url": "https://t.me/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Tumblr",
-    "url": "https://alex.tumblr.com",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Keybase",
-    "url": "https://keybase.io/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "HackerNews",
-    "url": "https://news.ycombinator.com/user?id=alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "GitLab",
-    "url": "https://gitlab.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Spotify",
-    "url": "https://open.spotify.com/user/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Quora",
-    "url": "https://www.quora.com/profile/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Roblox",
-    "url": "https://www.roblox.com/user.aspx?username=alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "VK",
-    "url": "https://vk.com/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Pastebin",
-    "url": "https://pastebin.com/u/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Imgur",
-    "url": "https://imgur.com/user/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  },
-  {
-    "platform": "Etsy",
-    "url": "https://www.etsy.com/shop/alex",
-    "available": null,
-    "recon_data": {},
-    "error": "Missing dependencies for SOCKS support."
-  }
-]
\ No newline at end of file

From 3f95a2fe81bdcdd3fe7633cb1ac068635d4c94bb Mon Sep 17 00:00:00 2001
From: stilla1ex <alexmwangimungai254@gmail.com>
Date: Tue, 12 Aug 2025 02:59:18 -0400
Subject: [PATCH 12/19] Minor changes

---
 BRANCH_STRATEGY.md | 103 ---------------------------------------------
 1 file changed, 103 deletions(-)
 delete mode 100644 BRANCH_STRATEGY.md

diff --git a/BRANCH_STRATEGY.md b/BRANCH_STRATEGY.md
deleted file mode 100644
index 4efd1841c..000000000
--- a/BRANCH_STRATEGY.md
+++ /dev/null
@@ -1,103 +0,0 @@
-# USRLINKS Branch Strategy
-
-## Repository Structure
-
-This repository maintains a clear separation between different implementation approaches:
-
-### Main Branch (`main`)
-- **Purpose**: Terminal-based OSINT tool
-- **Target Users**: Security professionals, penetration testers, CLI enthusiasts
-- **Key Features**:
-  - Command-line interface
-  - Static HTML report generation
-  - CSV/JSON export capabilities
-  - Lightweight and portable
-  - No web server dependencies
-
-### Web Version Branch (`web-version`) - Community Maintained
-- **Purpose**: Web-based interface for USRLINKS
-- **Target Users**: Users preferring graphical interfaces
-- **Key Features**:
-  - Web dashboard
-  - Real-time scanning
-  - Browser-based reports
-  - May include Flask/Django/FastAPI
-
-## Why This Separation?
-
-### Terminal Version Benefits:
-1. **Security**: No web server attack surface
-2. **Portability**: Runs anywhere Python runs
-3. **Integration**: Easy to integrate with other CLI tools
-4. **Performance**: Lower resource overhead
-5. **Scripting**: Perfect for automation and batch processing
-
-### Web Version Benefits:
-1. **Accessibility**: Easier for non-technical users
-2. **Visualization**: Rich graphical interfaces
-3. **Collaboration**: Easy to share with teams
-4. **Real-time**: Live updates and progress tracking
-
-## Contributing Guidelines
-
-### To Main Branch (Terminal)
-```bash
-# Clone and work on terminal features
-git clone https://github.com/stilla1ex/usrlinks.git
-cd usrlinks
-git checkout main
-# Make your terminal-focused changes
-git checkout -b feature/your-terminal-enhancement
-```
-
-### To Web Version Branch
-```bash
-# Clone and work on web features
-git clone https://github.com/stilla1ex/usrlinks.git
-cd usrlinks
-git checkout -b web-version origin/web-version  # If exists, or create new
-# Make your web-focused changes
-git checkout -b feature/your-web-enhancement
-```
-
-## Pull Request Guidelines
-
-### For Main Branch (Terminal)
-- ✅ New platform integrations
-- ✅ Performance improvements
-- ✅ Enhanced reconnaissance features
-- ✅ Better terminal output formatting
-- ✅ Export format improvements
-- ❌ Web servers or frameworks
-- ❌ Browser-based interfaces
-
-### For Web Version Branch
-- ✅ Web frameworks (Flask, Django, etc.)
-- ✅ Frontend interfaces
-- ✅ Web dashboards
-- ✅ Real-time features
-- ❌ Changes to core terminal functionality
-
-## Maintainer Notes
-
-As the project maintainer, you can:
-
-1. **Reject web-based PRs to main**: Politely redirect to web-ui branch
-2. **Set branch protection**: Require reviews for main branch
-3. **Use PR templates**: Guide contributors to the right branch
-4. **Community governance**: Let community maintain web branch if desired
-
-## Example Response to Web-Based PR
-
-```
-Thank you for your contribution! However, this repository maintains a terminal-first 
-approach on the main branch. 
-
-Your web-based enhancements would be perfect for the `web-version` branch. Please:
-
-1. Change your PR target from `main` to `web-version`
-2. Or let me know and I can redirect it for you
-3. Ensure your changes don't modify core terminal functionality
-
-This helps us maintain both approaches for different user needs.
-```

From 4ed0d26b649762f9714e0c7a63943d55e5200c51 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EF=B9=AB1=C2=B3=E2=9C=98=E2=86=AF?=
 <125695276+stilla1ex@users.noreply.github.com>
Date: Tue, 12 Aug 2025 03:16:36 -0400
Subject: [PATCH 13/19] Minor changes

---
 BRANCH_STRATEGY.md | 37 -------------------------------------
 1 file changed, 37 deletions(-)

diff --git a/BRANCH_STRATEGY.md b/BRANCH_STRATEGY.md
index 4efd1841c..84a7ec773 100644
--- a/BRANCH_STRATEGY.md
+++ b/BRANCH_STRATEGY.md
@@ -38,28 +38,6 @@ This repository maintains a clear separation between different implementation ap
 3. **Collaboration**: Easy to share with teams
 4. **Real-time**: Live updates and progress tracking
 
-## Contributing Guidelines
-
-### To Main Branch (Terminal)
-```bash
-# Clone and work on terminal features
-git clone https://github.com/stilla1ex/usrlinks.git
-cd usrlinks
-git checkout main
-# Make your terminal-focused changes
-git checkout -b feature/your-terminal-enhancement
-```
-
-### To Web Version Branch
-```bash
-# Clone and work on web features
-git clone https://github.com/stilla1ex/usrlinks.git
-cd usrlinks
-git checkout -b web-version origin/web-version  # If exists, or create new
-# Make your web-focused changes
-git checkout -b feature/your-web-enhancement
-```
-
 ## Pull Request Guidelines
 
 ### For Main Branch (Terminal)
@@ -86,18 +64,3 @@ As the project maintainer, you can:
 2. **Set branch protection**: Require reviews for main branch
 3. **Use PR templates**: Guide contributors to the right branch
 4. **Community governance**: Let community maintain web branch if desired
-
-## Example Response to Web-Based PR
-
-```
-Thank you for your contribution! However, this repository maintains a terminal-first 
-approach on the main branch. 
-
-Your web-based enhancements would be perfect for the `web-version` branch. Please:
-
-1. Change your PR target from `main` to `web-version`
-2. Or let me know and I can redirect it for you
-3. Ensure your changes don't modify core terminal functionality
-
-This helps us maintain both approaches for different user needs.
-```

From e7ceb6443751a8318a4e155c345105d26819fa06 Mon Sep 17 00:00:00 2001
From: stilla1ex <alexmwangimungai254@gmail.com>
Date: Tue, 12 Aug 2025 03:13:13 -0400
Subject: [PATCH 14/19] Update requirements.txt with new dependencies for PR #9

Added missing dependencies:
- rapidfuzz: for fuzzy string matching
- rich: for enhanced console output
- aiohttp: for asynchronous HTTP requests

These are required for the new fuzzy scanning and metadata extraction features.

Also updated BRANCH_STRATEGY.md with minor cleanup.
---
 BRANCH_STRATEGY.md | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/BRANCH_STRATEGY.md b/BRANCH_STRATEGY.md
index 84a7ec773..62e078877 100644
--- a/BRANCH_STRATEGY.md
+++ b/BRANCH_STRATEGY.md
@@ -55,12 +55,3 @@ This repository maintains a clear separation between different implementation ap
 - ✅ Web dashboards
 - ✅ Real-time features
 - ❌ Changes to core terminal functionality
-
-## Maintainer Notes
-
-As the project maintainer, you can:
-
-1. **Reject web-based PRs to main**: Politely redirect to web-ui branch
-2. **Set branch protection**: Require reviews for main branch
-3. **Use PR templates**: Guide contributors to the right branch
-4. **Community governance**: Let community maintain web branch if desired

From 712fcf7b4d33a8a488732f937bb361903744fa6a Mon Sep 17 00:00:00 2001
From: stilla1ex <alexmwangimungai254@gmail.com>
Date: Tue, 12 Aug 2025 03:14:40 -0400
Subject: [PATCH 15/19] Remove usrlinks.log from tracking (generated file)

---
 usrlinks.log | 68 ----------------------------------------------------
 1 file changed, 68 deletions(-)
 delete mode 100644 usrlinks.log

diff --git a/usrlinks.log b/usrlinks.log
deleted file mode 100644
index 7c2e4dfb1..000000000
--- a/usrlinks.log
+++ /dev/null
@@ -1,68 +0,0 @@
-2025-08-09 11:36:55,035 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 11:36:56,194 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 11:36:58,368 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 11:37:09,627 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 11:37:25,786 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 11:37:42,899 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 11:37:59,598 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 11:38:08,239 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 11:38:10,485 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 11:38:27,329 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 11:38:43,451 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 11:39:00,607 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 11:39:16,868 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 11:39:17,990 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 11:39:20,118 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 11:39:36,583 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 11:39:52,868 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 11:40:10,019 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:04:10,932 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 12:04:12,119 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 12:04:14,290 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 12:04:22,643 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:04:38,774 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:04:56,163 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:22:15,118 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 12:22:16,300 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 12:22:18,588 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 12:22:28,770 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:22:44,938 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:23:02,084 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:34:19,813 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 12:34:21,006 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 12:34:23,171 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /max
-2025-08-09 12:34:32,804 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:34:52,373 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:35:10,563 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:35:32,207 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@max
-2025-08-09 12:47:08,380 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='github.com', port=443): Read timed out. (read timeout=15)")': /ma@x
-2025-08-10 00:11:10,968 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:11:12,148 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:11:14,320 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:11:24,695 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:11:40,853 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:11:58,165 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:17:38,799 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:17:39,998 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:17:42,224 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:17:53,304 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:18:09,497 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:18:26,779 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:23:40,359 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:23:41,553 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:23:43,779 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:23:49,336 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:24:05,499 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:24:22,651 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:25:48,310 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:25:49,484 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:25:50,746 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLEOFError(8, '[SSL: UNEXPECTED_EOF_WHILE_READING] EOF occurred in violation of protocol (_ssl.c:1029)'))': /@stilla1ex
-2025-08-10 00:26:06,630 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='soundcloud.com', port=443): Read timed out. (read timeout=15)")': /stilla1ex
-2025-08-10 00:26:06,885 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:26:24,159 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:32:19,768 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:32:21,534 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:32:23,711 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectionResetError(104, 'Connection reset by peer')': /stilla1ex
-2025-08-10 00:32:33,127 [WARNING] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:32:49,318 [WARNING] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex
-2025-08-10 00:33:06,474 [WARNING] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='www.tiktok.com', port=443): Read timed out. (read timeout=15)")': /@stilla1ex

From f76ebd2381e4dfe7b53d59500ee86abe03c16513 Mon Sep 17 00:00:00 2001
From: stilla1ex <alexmwangimungai254@gmail.com>
Date: Tue, 12 Aug 2025 03:16:10 -0400
Subject: [PATCH 16/19] Add .gitignore to exclude log files and generated
 content

---
 .gitignore | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 .gitignore

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 000000000..384332738
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,33 @@
+# Log files
+*.log
+usrlinks.log
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+venv/
+env/
+test_env/
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Output files
+USRLINKS_*.csv
+USRLINKS_*.json
+
+# Results directory (keep structure but ignore contents)
+results/*.html
+results/*.csv
+results/*.json
+!results/.gitkeep

From e9dc6d9d4f837900be210651e1457d593e799c25 Mon Sep 17 00:00:00 2001
From: alex <alex@kali>
Date: Fri, 5 Sep 2025 04:40:37 -0400
Subject: [PATCH 17/19] Added platforms.json file. Minor changes on the readme
 file

---
 .gitignore            | 33 ---------------------
 BRANCH_STRATEGY.md    | 57 ------------------------------------
 CONTRIBUTING.md       | 68 -------------------------------------------
 README.md             | 61 +++++++-------------------------------
 config/platforms.json | 20 +++++++++++++
 usrlinks.sh           | 37 ++++++++++++-----------
 6 files changed, 51 insertions(+), 225 deletions(-)
 delete mode 100644 .gitignore
 delete mode 100644 BRANCH_STRATEGY.md
 delete mode 100644 CONTRIBUTING.md
 create mode 100644 config/platforms.json

diff --git a/.gitignore b/.gitignore
deleted file mode 100644
index 384332738..000000000
--- a/.gitignore
+++ /dev/null
@@ -1,33 +0,0 @@
-# Log files
-*.log
-usrlinks.log
-
-# Python cache
-__pycache__/
-*.py[cod]
-*$py.class
-
-# Virtual environments
-venv/
-env/
-test_env/
-
-# IDE files
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# OS files
-.DS_Store
-Thumbs.db
-
-# Output files
-USRLINKS_*.csv
-USRLINKS_*.json
-
-# Results directory (keep structure but ignore contents)
-results/*.html
-results/*.csv
-results/*.json
-!results/.gitkeep
diff --git a/BRANCH_STRATEGY.md b/BRANCH_STRATEGY.md
deleted file mode 100644
index 62e078877..000000000
--- a/BRANCH_STRATEGY.md
+++ /dev/null
@@ -1,57 +0,0 @@
-# USRLINKS Branch Strategy
-
-## Repository Structure
-
-This repository maintains a clear separation between different implementation approaches:
-
-### Main Branch (`main`)
-- **Purpose**: Terminal-based OSINT tool
-- **Target Users**: Security professionals, penetration testers, CLI enthusiasts
-- **Key Features**:
-  - Command-line interface
-  - Static HTML report generation
-  - CSV/JSON export capabilities
-  - Lightweight and portable
-  - No web server dependencies
-
-### Web Version Branch (`web-version`) - Community Maintained
-- **Purpose**: Web-based interface for USRLINKS
-- **Target Users**: Users preferring graphical interfaces
-- **Key Features**:
-  - Web dashboard
-  - Real-time scanning
-  - Browser-based reports
-  - May include Flask/Django/FastAPI
-
-## Why This Separation?
-
-### Terminal Version Benefits:
-1. **Security**: No web server attack surface
-2. **Portability**: Runs anywhere Python runs
-3. **Integration**: Easy to integrate with other CLI tools
-4. **Performance**: Lower resource overhead
-5. **Scripting**: Perfect for automation and batch processing
-
-### Web Version Benefits:
-1. **Accessibility**: Easier for non-technical users
-2. **Visualization**: Rich graphical interfaces
-3. **Collaboration**: Easy to share with teams
-4. **Real-time**: Live updates and progress tracking
-
-## Pull Request Guidelines
-
-### For Main Branch (Terminal)
-- ✅ New platform integrations
-- ✅ Performance improvements
-- ✅ Enhanced reconnaissance features
-- ✅ Better terminal output formatting
-- ✅ Export format improvements
-- ❌ Web servers or frameworks
-- ❌ Browser-based interfaces
-
-### For Web Version Branch
-- ✅ Web frameworks (Flask, Django, etc.)
-- ✅ Frontend interfaces
-- ✅ Web dashboards
-- ✅ Real-time features
-- ❌ Changes to core terminal functionality
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
deleted file mode 100644
index a8fb8a354..000000000
--- a/CONTRIBUTING.md
+++ /dev/null
@@ -1,68 +0,0 @@
-# Contributing to USRLINKS
-
-## Project Vision
-
-USRLINKS is designed as a **terminal-based OSINT tool** with the following core principles:
-
-- **Terminal-first interface**: Primary interaction through command line
-- **Static report generation**: HTML reports are generated as static files, not served by a web server
-- **Lightweight and portable**: No web framework dependencies
-- **Security-focused**: Suitable for penetration testing and OSINT investigations
-
-## Branch Strategy
-
-- **`main` branch**: Terminal-only implementation (protected)
-- **`web-version` branch**: For web-based contributions (if community wants this)
-- **Feature branches**: For specific enhancements
-
-## Contributing Guidelines
-
-### For Terminal-Based Features (main branch)
-✅ **Accepted contributions:**
-- New platform integrations
-- Enhanced reconnaissance capabilities
-- Performance improvements
-- Better terminal output formatting
-- CSV/JSON export enhancements
-- Bug fixes and security improvements
-
-❌ **Not accepted on main branch:**
-- Web servers (Flask, Django, FastAPI, etc.)
-- Live web interfaces
-- Real-time web dashboards
-- Browser-based scanning interfaces
-
-### For Web-Based Features (separate branch)
-If you want to contribute web-based functionality:
-1. Create or use the `web-version` branch
-2. Ensure it doesn't modify core terminal functionality
-3. Keep it as a separate application layer
-
-## How to Contribute
-
-1. **Fork the repository**
-2. **Choose the right branch:**
-   - Use `main` for terminal enhancements
-   - Use `web-version` for web features
-3. **Create a feature branch** from the appropriate base
-4. **Submit a pull request** to the correct target branch
-
-## Code Standards
-
-- Maintain Python 3.6+ compatibility
-- Follow existing code style
-- Include proper error handling
-- Add logging for debugging
-- Update documentation for new features
-
-## Testing
-
-Before submitting:
-- Test on multiple platforms
-- Verify terminal output formatting
-- Ensure no web framework dependencies in main branch
-- Test with various usernames and edge cases
-
----
-
-**Remember**: The main branch stays terminal-focused to maintain the tool's core identity and use case.
diff --git a/README.md b/README.md
index c3b6f1dbb..7d194720f 100644
--- a/README.md
+++ b/README.md
@@ -1,64 +1,25 @@
-<img width="1023" height="614" alt="image" src="https://github.com/user-attachments/assets/d7d74273-e552-426b-a15d-7241193950e2" />
+USRLINKS
+========
 
-## Supported Platforms
-
-Major Social Networks: GitHub, Twitter, Instagram, LinkedIn, TikTok, Facebook, Reddit, YouTube, Twitch
-Professional: LinkedIn, GitHub, GitLab, Bitbucket, HackerNews, Medium
-Media & Creative: Instagram, YouTube, TikTok, Vimeo, SoundCloud, DeviantArt, Pinterest
-Gaming: Steam, Twitch, Roblox
-Communication: Telegram, Discord, Skype
-Marketplaces: Etsy, eBay
-And 80+ more platforms.
-
-
-
-
-# USRLINKS - Advanced OSINT Username Hunter
-
-USRLINKS is a comprehensive Python reconnaissance tool that checks username availability across 100+ social media platforms and performs deep OSINT intelligence gathering. The tool features both command-line interface and web-based functionality, designed for security professionals, penetration testers, and OSINT investigators.
-
-USRLINKS provides flexible deployment options with both terminal-based scanning and web interface capabilities for maximum portability, security, and integration with existing OSINT workflows. Reports are generated in multiple formats including HTML, JSON, and CSV for easy sharing and documentation.
-
-## Features
-
-### Core Functionality
-- 100+ Platform Coverage: Scan username availability across major social networks, forums, and platforms
-- Deep Reconnaissance: Extract emails, phone numbers, locations, and bio information from profiles
-- Profile Intelligence: Analyze profile images with hash generation for cross-platform correlation
-- Google Dorks Generator: Automatically generate targeted search queries for enhanced OSINT
-- Advanced Reporting: Beautiful HTML reports with interactive tables and reconnaissance data
-- Export Options: CSV and JSON formats for data analysis and integration
-
-### Technical Features
-- Multi-threaded Scanning: Fast concurrent processing for efficient reconnaissance
-- Proxy & Tor Support: Anonymous scanning with SOCKS/HTTP proxy support
-- Retry Logic: Intelligent retry mechanisms for failed requests
-- User Agent Rotation: Anti-detection measures with randomized headers
-- Platform-Specific Detection: Custom logic for accurate availability detection
-- Web Interface: Browser-based interface for ease of use and accessibility
-- Command Line Interface: Terminal-based operation for automation and scripting
-
-## Installation
+USRLINKS is a command-line tool for checking username availability and gathering public profile data across multiple platforms.
 
+**Install:**
 ```bash
-git clone https://github.com/stilla1ex/usrlinks.git
+git clone https://github.com/wh1t3h4ts/usrlinks.git
 cd usrlinks
 pip install -r requirements.txt
 chmod +x usrlinks.sh
 ```
 
-## Quick Start
-
-### Simple Launcher (Recommended)
-The easiest way to use USRLINKS with automatic HTML report generation:
-
+**Usage:**
 ```bash
-# Basic scan with HTML report
-./usrlinks.sh -u john_doe
+./usrlinks.sh -u username [options]
+```
+Options include `--deep-scan`, `--list-platforms`, and `--generate-dorks`.
 
-# Deep scan with reconnaissance data
-./usrlinks.sh -u john_doe --deep-scan
+Results are saved in the `results/` directory.
 
+Supported platforms are listed in `config/platforms.json`.
 # List all supported platforms
 ./usrlinks.sh --list-platforms
 ```
diff --git a/config/platforms.json b/config/platforms.json
new file mode 100644
index 000000000..d35fc2a87
--- /dev/null
+++ b/config/platforms.json
@@ -0,0 +1,20 @@
+[
+  {
+    "name": "GitHub",
+    "url": "https://github.com/{username}",
+    "errorType": "status_code",
+    "valid": true,
+    "availableStatusCode": 404,
+    "takenStatusCode": 200,
+    "profile": true
+  },
+  {
+    "name": "Twitter",
+    "url": "https://twitter.com/{username}",
+    "errorType": "status_code",
+    "valid": true,
+    "availableStatusCode": 404,
+    "takenStatusCode": 200,
+    "profile": true
+  }
+]
diff --git a/usrlinks.sh b/usrlinks.sh
index 71b2ee643..a3d06ca1a 100755
--- a/usrlinks.sh
+++ b/usrlinks.sh
@@ -91,31 +91,31 @@ cat > "$HTML_FILE" << EOF
         body {
             font-family: 'Arial', sans-serif;
             line-height: 1.6;
-            color: #333;
+            color: #e0e0e0;
             max-width: 1200px;
             margin: 0 auto;
             padding: 20px;
-            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            background: linear-gradient(135deg, #1a1a1a 0%, #2d2d2d 100%);
             min-height: 100vh;
         }
         .container {
-            background: white;
+            background: #333;
             border-radius: 15px;
-            box-shadow: 0 10px 30px rgba(0,0,0,0.3);
+            box-shadow: 0 10px 30px rgba(0,0,0,0.5);
             padding: 30px;
         }
         .header {
             text-align: center;
             margin-bottom: 30px;
             padding: 20px;
-            background: linear-gradient(45deg, #667eea, #764ba2);
-            color: white;
+            background: linear-gradient(45deg, #444, #555);
+            color: #fff;
             border-radius: 10px;
         }
         .header h1 {
             margin: 0;
             font-size: 2.5em;
-            text-shadow: 2px 2px 4px rgba(0,0,0,0.3);
+            text-shadow: 2px 2px 4px rgba(0,0,0,0.5);
         }
         .summary {
             display: grid;
@@ -124,11 +124,12 @@ cat > "$HTML_FILE" << EOF
             margin: 20px 0;
         }
         .summary-card {
-            background: #f8f9fa;
+            background: #444;
             padding: 15px;
             border-radius: 8px;
             text-align: center;
             border-left: 4px solid #667eea;
+            color: #e0e0e0;
         }
         .summary-number {
             font-size: 2em;
@@ -139,20 +140,20 @@ cat > "$HTML_FILE" << EOF
             width: 100%;
             border-collapse: collapse;
             margin: 20px 0;
-            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+            box-shadow: 0 2px 10px rgba(0,0,0,0.3);
         }
         .results-table th,
         .results-table td {
             padding: 12px;
             text-align: left;
-            border-bottom: 1px solid #ddd;
+            border-bottom: 1px solid #555;
         }
         .results-table th {
-            background: linear-gradient(45deg, #667eea, #764ba2);
-            color: white;
+            background: linear-gradient(45deg, #444, #555);
+            color: #fff;
         }
         .results-table tr:hover {
-            background-color: #f5f5f5;
+            background-color: #444;
         }
         .status-available {
             color: #28a745;
@@ -169,17 +170,18 @@ cat > "$HTML_FILE" << EOF
         .recon-section {
             margin: 20px 0;
             padding: 20px;
-            background: #f8f9fa;
+            background: #444;
             border-radius: 8px;
             border-left: 4px solid #28a745;
+            color: #e0e0e0;
         }
         .footer {
             text-align: center;
             margin-top: 30px;
             padding: 20px;
-            background: #f8f9fa;
+            background: #444;
             border-radius: 8px;
-            color: #666;
+            color: #aaa;
         }
         .url-link {
             color: #667eea;
@@ -189,11 +191,12 @@ cat > "$HTML_FILE" << EOF
             text-decoration: underline;
         }
         .recon-item {
-            background: white;
+            background: #333;
             margin: 10px 0;
             padding: 15px;
             border-radius: 5px;
             border-left: 3px solid #17a2b8;
+            color: #e0e0e0;
         }
     </style>
 </head>

From ac61aec1cf3f095b04275ea99239a13e3ff84610 Mon Sep 17 00:00:00 2001
From: alex <wh1t3h4t@kali>
Date: Sat, 20 Sep 2025 05:03:13 +0300
Subject: [PATCH 18/19] Minor changes

---
 USRLINKS_alex_20250920_045943.json            | 275 +++++++++++++++
 config/platforms.json                         |  63 +++-
 .../USRLINKS_Report_alex_20250920_045931.html | 236 +++++++++++++
 usrlinks.log                                  |   0
 usrlinks.py                                   | 328 ++++++++++++------
 usrlinks.sh                                   |   3 -
 6 files changed, 774 insertions(+), 131 deletions(-)
 create mode 100644 USRLINKS_alex_20250920_045943.json
 create mode 100644 results/USRLINKS_Report_alex_20250920_045931.html
 create mode 100644 usrlinks.log

diff --git a/USRLINKS_alex_20250920_045943.json b/USRLINKS_alex_20250920_045943.json
new file mode 100644
index 000000000..d34db69cd
--- /dev/null
+++ b/USRLINKS_alex_20250920_045943.json
@@ -0,0 +1,275 @@
+[
+  {
+    "platform": "YouTube",
+    "url": "https://youtube.com/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Twitter",
+    "url": "https://twitter.com/alex",
+    "available": false,
+    "recon_data": {
+      "contact_info": {
+        "emails": [],
+        "phones": [
+          "2025"
+        ],
+        "urls": [],
+        "location": null,
+        "bio": null,
+        "name": null,
+        "verified": false
+      },
+      "profile_image": {
+        "url": null,
+        "hash": null,
+        "downloaded": false
+      }
+    }
+  },
+  {
+    "platform": "LinkedIn",
+    "url": "https://linkedin.com/in/alex",
+    "available": false,
+    "recon_data": {
+      "contact_info": {
+        "emails": [],
+        "phones": [
+          "2015",
+          "2019",
+          "2023",
+          "2016",
+          "2025"
+        ],
+        "urls": [
+          "www.curated.com",
+          "https://www.curated.com/careers",
+          "www.curated.com/careers",
+          "https://www.curated.com"
+        ],
+        "location": null,
+        "bio": null,
+        "name": null,
+        "verified": false
+      },
+      "profile_image": {
+        "url": null,
+        "hash": null,
+        "downloaded": false
+      }
+    }
+  },
+  {
+    "platform": "Twitch",
+    "url": "https://twitch.tv/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "TikTok",
+    "url": "https://tiktok.com/@alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Facebook",
+    "url": "https://facebook.com/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Instagram",
+    "url": "https://instagram.com/alex",
+    "available": false,
+    "recon_data": {
+      "contact_info": {
+        "emails": [],
+        "phones": [],
+        "urls": [],
+        "location": null,
+        "bio": null,
+        "name": null,
+        "verified": false
+      },
+      "profile_image": {
+        "url": null,
+        "hash": null,
+        "downloaded": false
+      }
+    }
+  },
+  {
+    "platform": "Reddit",
+    "url": "https://reddit.com/user/alex",
+    "available": false,
+    "recon_data": {
+      "contact_info": {
+        "emails": [],
+        "phones": [],
+        "urls": [],
+        "location": null,
+        "bio": null,
+        "name": null,
+        "verified": false
+      },
+      "profile_image": {
+        "url": null,
+        "hash": null,
+        "downloaded": false
+      }
+    }
+  },
+  {
+    "platform": "Steam",
+    "url": "https://steamcommunity.com/id/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "GitHub",
+    "url": "https://github.com/alex",
+    "available": false,
+    "recon_data": {
+      "contact_info": {
+        "emails": [],
+        "phones": [
+          "2020",
+          "2025"
+        ],
+        "urls": [
+          "https://alexgaynor.net"
+        ],
+        "location": "Washington D.C.",
+        "bio": "I program computers, and build teams that program computers, with a heavy focus on security.",
+        "name": "Alex Gaynor",
+        "verified": false
+      },
+      "profile_image": {
+        "url": "https://avatars.githubusercontent.com/u/772?s=64&v=4",
+        "hash": "b0030b738edc295b14e5c237f4649bfe",
+        "downloaded": false
+      }
+    }
+  },
+  {
+    "platform": "Vimeo",
+    "url": "https://vimeo.com/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "SoundCloud",
+    "url": "https://soundcloud.com/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Telegram",
+    "url": "https://t.me/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Medium",
+    "url": "https://medium.com/@alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "GitLab",
+    "url": "https://gitlab.com/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "CodePen",
+    "url": "https://codepen.io/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Keybase",
+    "url": "https://keybase.io/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Bitbucket",
+    "url": "https://bitbucket.org/alex",
+    "available": true,
+    "recon_data": {}
+  },
+  {
+    "platform": "HackerNews",
+    "url": "https://news.ycombinator.com/user?id=alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "DeviantArt",
+    "url": "https://alex.deviantart.com",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Pinterest",
+    "url": "https://pinterest.com/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Tumblr",
+    "url": "https://alex.tumblr.com",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Quora",
+    "url": "https://www.quora.com/profile/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Spotify",
+    "url": "https://open.spotify.com/user/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Imgur",
+    "url": "https://imgur.com/user/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "VK",
+    "url": "https://vk.com/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Last.fm",
+    "url": "https://last.fm/user/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Pastebin",
+    "url": "https://pastebin.com/u/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Etsy",
+    "url": "https://www.etsy.com/shop/alex",
+    "available": false,
+    "recon_data": {}
+  },
+  {
+    "platform": "Roblox",
+    "url": "https://www.roblox.com/user.aspx?username=alex",
+    "available": true,
+    "recon_data": {}
+  }
+]
\ No newline at end of file
diff --git a/config/platforms.json b/config/platforms.json
index d35fc2a87..aa4997429 100644
--- a/config/platforms.json
+++ b/config/platforms.json
@@ -1,20 +1,51 @@
-[
-  {
-    "name": "GitHub",
+{
+  "GitHub": {
     "url": "https://github.com/{username}",
-    "errorType": "status_code",
-    "valid": true,
-    "availableStatusCode": 404,
-    "takenStatusCode": 200,
-    "profile": true
+    "method": "status_code",
+    "code": [404],
+    "recon_enabled": true,
+    "api_endpoint": "https://api.github.com/users/{username}"
   },
-  {
-    "name": "Twitter",
+  "Twitter": {
     "url": "https://twitter.com/{username}",
-    "errorType": "status_code",
-    "valid": true,
-    "availableStatusCode": 404,
-    "takenStatusCode": 200,
-    "profile": true
+    "method": "response_text",
+    "error_msg": ["doesn't exist", "404"],
+    "recon_enabled": true
+  },
+  "Instagram": {
+    "url": "https://instagram.com/{username}",
+    "method": "status_code", 
+    "code": [404],
+    "recon_enabled": true
+  },
+  "Reddit": {
+    "url": "https://reddit.com/user/{username}",
+    "method": "status_code",
+    "code": [404],
+    "recon_enabled": true
+  },
+  "LinkedIn": {
+    "url": "https://linkedin.com/in/{username}",
+    "method": "status_code",
+    "code": [404],
+    "recon_enabled": true
+  },
+  "TikTok": {
+    "url": "https://tiktok.com/@{username}",
+    "method": "response_text",
+    "error_msg": ["Couldn't find this account"],
+    "recon_enabled": false
+  },
+  "YouTube": {
+    "url": "https://youtube.com/{username}",
+    "method": "response_text", 
+    "error_msg": ["This channel does not exist"],
+    "recon_enabled": false
+  },
+  "Twitch": {
+    "url": "https://twitch.tv/{username}",
+    "method": "status_code",
+    "code": [404],
+    "recon_enabled": false
   }
-]
+}
diff --git a/results/USRLINKS_Report_alex_20250920_045931.html b/results/USRLINKS_Report_alex_20250920_045931.html
new file mode 100644
index 000000000..f3e6ac68d
--- /dev/null
+++ b/results/USRLINKS_Report_alex_20250920_045931.html
@@ -0,0 +1,236 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>USRLINKS Report - alex</title>
+    <style>
+        body {
+            font-family: 'Arial', sans-serif;
+            line-height: 1.6;
+            color: #e0e0e0;
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 20px;
+            background: linear-gradient(135deg, #1a1a1a 0%, #2d2d2d 100%);
+            min-height: 100vh;
+        }
+        .container {
+            background: #333;
+            border-radius: 15px;
+            box-shadow: 0 10px 30px rgba(0,0,0,0.5);
+            padding: 30px;
+        }
+        .header {
+            text-align: center;
+            margin-bottom: 30px;
+            padding: 20px;
+            background: linear-gradient(45deg, #444, #555);
+            color: #fff;
+            border-radius: 10px;
+        }
+        .header h1 {
+            margin: 0;
+            font-size: 2.5em;
+            text-shadow: 2px 2px 4px rgba(0,0,0,0.5);
+        }
+        .summary {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
+            gap: 15px;
+            margin: 20px 0;
+        }
+        .summary-card {
+            background: #444;
+            padding: 15px;
+            border-radius: 8px;
+            text-align: center;
+            border-left: 4px solid #667eea;
+            color: #e0e0e0;
+        }
+        .summary-number {
+            font-size: 2em;
+            font-weight: bold;
+            color: #667eea;
+        }
+        .results-table {
+            width: 100%;
+            border-collapse: collapse;
+            margin: 20px 0;
+            box-shadow: 0 2px 10px rgba(0,0,0,0.3);
+        }
+        .results-table th,
+        .results-table td {
+            padding: 12px;
+            text-align: left;
+            border-bottom: 1px solid #555;
+        }
+        .results-table th {
+            background: linear-gradient(45deg, #444, #555);
+            color: #fff;
+        }
+        .results-table tr:hover {
+            background-color: #444;
+        }
+        .status-available {
+            color: #28a745;
+            font-weight: bold;
+        }
+        .status-taken {
+            color: #dc3545;
+            font-weight: bold;
+        }
+        .status-error {
+            color: #ffc107;
+            font-weight: bold;
+        }
+        .recon-section {
+            margin: 20px 0;
+            padding: 20px;
+            background: #444;
+            border-radius: 8px;
+            border-left: 4px solid #28a745;
+            color: #e0e0e0;
+        }
+        .footer {
+            text-align: center;
+            margin-top: 30px;
+            padding: 20px;
+            background: #444;
+            border-radius: 8px;
+            color: #aaa;
+        }
+        .url-link {
+            color: #667eea;
+            text-decoration: none;
+        }
+        .url-link:hover {
+            text-decoration: underline;
+        }
+        .recon-item {
+            background: #333;
+            margin: 10px 0;
+            padding: 15px;
+            border-radius: 5px;
+            border-left: 3px solid #17a2b8;
+            color: #e0e0e0;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>🔍 USRLINKS Report</h1>
+            <h2>Username: alex</h2>
+            <p>Generated on Sat Sep 20 04:59:43 AM EAT 2025</p>
+        </div>
+
+        <div id="summary" class="summary">
+            <!-- Summary will be populated by JavaScript -->
+        </div>
+
+        <table class="results-table">
+            <thead>
+                <tr>
+                    <th>Platform</th>
+                    <th>Status</th>
+                    <th>URL</th>
+                    <th>Action</th>
+                </tr>
+            </thead>
+            <tbody id="results-body">
+                <!-- Results will be populated by JavaScript -->
+            </tbody>
+        </table>
+
+        <div id="recon-data" class="recon-section" style="display: none;">
+            <h3>🕵️ Reconnaissance Data</h3>
+            <div id="recon-content"></div>
+        </div>
+
+        <div class="footer">
+            <p><strong>USRLINKS</strong> - OSINT Username Hunter</p>
+            <p>Scan completed at Sat Sep 20 04:59:43 AM EAT 2025</p>
+        </div>
+    </div>
+
+    <script>
+        // Load JSON data
+        const results = [{"platform": "YouTube", "url": "https://youtube.com/alex", "available": false, "recon_data": {}}, {"platform": "Twitter", "url": "https://twitter.com/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": ["2025"], "urls": [], "location": null, "bio": null, "name": null, "verified": false}, "profile_image": {"url": null, "hash": null, "downloaded": false}}}, {"platform": "LinkedIn", "url": "https://linkedin.com/in/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": ["2015", "2019", "2023", "2016", "2025"], "urls": ["www.curated.com", "https://www.curated.com/careers", "www.curated.com/careers", "https://www.curated.com"], "location": null, "bio": null, "name": null, "verified": false}, "profile_image": {"url": null, "hash": null, "downloaded": false}}}, {"platform": "Twitch", "url": "https://twitch.tv/alex", "available": false, "recon_data": {}}, {"platform": "TikTok", "url": "https://tiktok.com/@alex", "available": false, "recon_data": {}}, {"platform": "Facebook", "url": "https://facebook.com/alex", "available": false, "recon_data": {}}, {"platform": "Instagram", "url": "https://instagram.com/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": [], "urls": [], "location": null, "bio": null, "name": null, "verified": false}, "profile_image": {"url": null, "hash": null, "downloaded": false}}}, {"platform": "Reddit", "url": "https://reddit.com/user/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": [], "urls": [], "location": null, "bio": null, "name": null, "verified": false}, "profile_image": {"url": null, "hash": null, "downloaded": false}}}, {"platform": "Steam", "url": "https://steamcommunity.com/id/alex", "available": false, "recon_data": {}}, {"platform": "GitHub", "url": "https://github.com/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": ["2020", "2025"], "urls": ["https://alexgaynor.net"], "location": "Washington D.C.", "bio": "I program computers, and build teams that program computers, with a heavy focus on security.", "name": "Alex Gaynor", "verified": false}, "profile_image": {"url": "https://avatars.githubusercontent.com/u/772?s=64&v=4", "hash": "b0030b738edc295b14e5c237f4649bfe", "downloaded": false}}}, {"platform": "Vimeo", "url": "https://vimeo.com/alex", "available": false, "recon_data": {}}, {"platform": "SoundCloud", "url": "https://soundcloud.com/alex", "available": false, "recon_data": {}}, {"platform": "Telegram", "url": "https://t.me/alex", "available": false, "recon_data": {}}, {"platform": "Medium", "url": "https://medium.com/@alex", "available": false, "recon_data": {}}, {"platform": "GitLab", "url": "https://gitlab.com/alex", "available": false, "recon_data": {}}, {"platform": "CodePen", "url": "https://codepen.io/alex", "available": false, "recon_data": {}}, {"platform": "Keybase", "url": "https://keybase.io/alex", "available": false, "recon_data": {}}, {"platform": "Bitbucket", "url": "https://bitbucket.org/alex", "available": true, "recon_data": {}}, {"platform": "HackerNews", "url": "https://news.ycombinator.com/user?id=alex", "available": false, "recon_data": {}}, {"platform": "DeviantArt", "url": "https://alex.deviantart.com", "available": false, "recon_data": {}}, {"platform": "Pinterest", "url": "https://pinterest.com/alex", "available": false, "recon_data": {}}, {"platform": "Tumblr", "url": "https://alex.tumblr.com", "available": false, "recon_data": {}}, {"platform": "Quora", "url": "https://www.quora.com/profile/alex", "available": false, "recon_data": {}}, {"platform": "Spotify", "url": "https://open.spotify.com/user/alex", "available": false, "recon_data": {}}, {"platform": "Imgur", "url": "https://imgur.com/user/alex", "available": false, "recon_data": {}}, {"platform": "VK", "url": "https://vk.com/alex", "available": false, "recon_data": {}}, {"platform": "Last.fm", "url": "https://last.fm/user/alex", "available": false, "recon_data": {}}, {"platform": "Pastebin", "url": "https://pastebin.com/u/alex", "available": false, "recon_data": {}}, {"platform": "Etsy", "url": "https://www.etsy.com/shop/alex", "available": false, "recon_data": {}}, {"platform": "Roblox", "url": "https://www.roblox.com/user.aspx?username=alex", "available": true, "recon_data": {}}];
+        
+        // Calculate summary statistics
+        let available = 0, taken = 0, errors = 0;
+        results.forEach(result => {
+            if (result.available === true) available++;
+            else if (result.available === false) taken++;
+            else errors++;
+        });
+
+        // Populate summary
+        document.getElementById('summary').innerHTML = `
+            <div class="summary-card">
+                <div class="summary-number">${available}</div>
+                <div>Available</div>
+            </div>
+            <div class="summary-card">
+                <div class="summary-number">${taken}</div>
+                <div>Taken</div>
+            </div>
+            <div class="summary-card">
+                <div class="summary-number">${errors}</div>
+                <div>Errors</div>
+            </div>
+            <div class="summary-card">
+                <div class="summary-number">${results.length}</div>
+                <div>Total Platforms</div>
+            </div>
+        `;
+
+        // Populate results table
+        const tbody = document.getElementById('results-body');
+        results.sort((a, b) => a.platform.localeCompare(b.platform)).forEach(result => {
+            const row = document.createElement('tr');
+            
+            let statusClass = 'status-error';
+            let statusText = 'ERROR';
+            let actionButton = '';
+            
+            if (result.available === true) {
+                statusClass = 'status-available';
+                statusText = '✅ AVAILABLE';
+                actionButton = `<a href="${result.url}" target="_blank" class="url-link">Visit</a>`;
+            } else if (result.available === false) {
+                statusClass = 'status-taken';
+                statusText = '❌ TAKEN';
+                actionButton = `<a href="${result.url}" target="_blank" class="url-link">View Profile</a>`;
+            }
+            
+            row.innerHTML = `
+                <td><strong>${result.platform}</strong></td>
+                <td class="${statusClass}">${statusText}</td>
+                <td><a href="${result.url}" target="_blank" class="url-link">${result.url}</a></td>
+                <td>${actionButton}</td>
+            `;
+            tbody.appendChild(row);
+        });
+
+        // Check for reconnaissance data
+        const hasReconData = results.some(r => r.recon_data && Object.keys(r.recon_data).length > 0);
+        if (hasReconData) {
+            document.getElementById('recon-data').style.display = 'block';
+            let reconHtml = '<h4>🔍 Deep Scan Results</h4>';
+            
+            results.forEach(result => {
+                if (result.recon_data && Object.keys(result.recon_data).length > 0) {
+                    reconHtml += `<div class="recon-item">
+                        <h5>${result.platform}</h5>
+                        <pre style="background: #f8f9fa; padding: 10px; border-radius: 3px; overflow-x: auto;">${JSON.stringify(result.recon_data, null, 2)}</pre>
+                    </div>`;
+                }
+            });
+            
+            document.getElementById('recon-content').innerHTML = reconHtml;
+        }
+    </script>
+</body>
+</html>
diff --git a/usrlinks.log b/usrlinks.log
new file mode 100644
index 000000000..e69de29bb
diff --git a/usrlinks.py b/usrlinks.py
index 6075c422f..3a5f89ecb 100644
--- a/usrlinks.py
+++ b/usrlinks.py
@@ -1,49 +1,51 @@
 #!/usr/bin/env python3
 """
 USRLINKS - Advanced OSINT Username Hunter
-Terminal-based tool to check username availability across 100+ platforms.
 
-This is intentionally designed as a command-line tool for:
-- Maximum portability and security
-- Integration with existing OSINT workflows  
-- Use in penetration testing environments
-- Automation and batch processing
-
-Web-based interfaces are maintained separately on the 'web-ui' branch.
+A comprehensive tool for checking username availability and gathering
+public profile data across multiple platforms.
 """
 
-import os
-import sys
-import time
-import json
+import asyncio
+import argparse
 import csv
+import hashlib
+import itertools
+import json
+import logging
+import os
 import random
-import argparse
 import re
-import hashlib
+import sys
+import time
+from collections import deque
 from datetime import datetime
 from urllib.parse import urlparse
+
+import aiohttp
 import requests
-from requests.adapters import HTTPAdapter, Retry
 from bs4 import BeautifulSoup
-from tqdm import tqdm
-import logging
-import itertools
 from rapidfuzz import fuzz
+from requests.adapters import HTTPAdapter, Retry
+from rich import box
 from rich.console import Console
 from rich.table import Table as RichTable
-from rich import box
-import asyncio
-import aiohttp
+from tqdm import tqdm
 
-# try exception block
+# Optional dependencies
 try:
     from fake_useragent import UserAgent
     FAKE_UA_AVAILABLE = True
 except ImportError:
     FAKE_UA_AVAILABLE = False
 
-  # --- Logging Setup ----
+try:
+    from tabulate import tabulate
+    TABULATE_AVAILABLE = True
+except ImportError:
+    TABULATE_AVAILABLE = False
+
+# --- Logging Setup ---
 logging.basicConfig(
     filename="usrlinks.log",
     level=logging.INFO,
@@ -52,8 +54,9 @@
 
 
 
-# --- Styling & Terminal UI ---
+# --- Constants and Configuration ---
 class Colors:
+    """ANSI color codes for terminal output."""
     RED = "\033[1;31m"
     GREEN = "\033[1;32m"
     YELLOW = "\033[1;33m"
@@ -68,15 +71,26 @@ class Colors:
     PROGRESS_TEXT = "\033[1;36m"
     ERROR = "\033[1;31m"
 
+
+FALLBACK_UA_LIST = [
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Safari/605.1.15",
+    "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+]
+
 class Table:
+    """Simple table formatter for terminal output."""
+    
     def __init__(self, headers):
         self.headers = headers
         self.rows = []
     
     def add_row(self, row):
+        """Add a row to the table."""
         self.rows.append(row)
     
     def display(self):
+        """Display the table with proper formatting."""
         col_widths = [len(header) for header in self.headers]
         for row in self.rows:
             for i, cell in enumerate(row):
@@ -97,6 +111,8 @@ def display(self):
 
 # --- Enhanced Reconnaissance Class ---
 class EnhancedRecon:
+    """Advanced reconnaissance module for extracting profile information."""
+    
     def __init__(self, session):
         self.session = session
         self.email_patterns = [
@@ -113,7 +129,7 @@ def __init__(self, session):
         ]
 
     def extract_contact_info(self, soup, url):
-        """Extract email addresses and phone numbers from profile pages"""
+        """Extract email addresses and phone numbers from profile pages."""
         contact_info = {
             'emails': [],
             'phones': [],
@@ -150,7 +166,7 @@ def extract_contact_info(self, soup, url):
         return contact_info
 
     def _extract_platform_specific(self, soup, url):
-        """Extract platform-specific information"""
+        """Extract platform-specific information."""
         info = {'location': None, 'bio': None, 'name': None, 'verified': False}
         
         if 'github.com' in url:
@@ -165,7 +181,7 @@ def _extract_platform_specific(self, soup, url):
         return info
 
     def _extract_github_info(self, soup):
-        """Extract GitHub-specific information"""
+        """Extract GitHub-specific information."""
         info = {}
         
         # Location
@@ -186,7 +202,7 @@ def _extract_github_info(self, soup):
         return info
 
     def _extract_twitter_info(self, soup):
-        """Extract Twitter/X-specific information"""
+        """Extract Twitter/X-specific information."""
         info = {}
         
         # Bio
@@ -206,7 +222,7 @@ def _extract_twitter_info(self, soup):
         return info
 
     def _extract_instagram_info(self, soup):
-        """Extract Instagram-specific information"""
+        """Extract Instagram-specific information."""
         info = {}
         
         # Bio (Instagram stores bio in meta tags)
@@ -217,7 +233,7 @@ def _extract_instagram_info(self, soup):
         return info
 
     def _extract_linkedin_info(self, soup):
-        """Extract LinkedIn-specific information"""
+        """Extract LinkedIn-specific information."""
         info = {}
         
         # Location
@@ -228,7 +244,7 @@ def _extract_linkedin_info(self, soup):
         return info
 
     def extract_profile_image(self, soup, url):
-        """Extract profile image URL and generate hash"""
+        """Extract profile image URL and generate hash."""
         profile_image_info = {
             'url': None,
             'hash': None,
@@ -262,7 +278,7 @@ def extract_profile_image(self, soup, url):
         return profile_image_info
 
     def _generate_image_hash(self, img_url):
-        """Generate hash of profile image for comparison"""
+        """Generate hash of profile image for comparison."""
         try:
             response = self.session.get(img_url, timeout=10)
             if response.status_code == 200:
@@ -272,7 +288,7 @@ def _generate_image_hash(self, img_url):
         return None
 
     def generate_google_dorks(self, username):
-        """Generate Google search dorks for the username"""
+        """Generate Google search dorks for the username."""
         dorks = [
             f'"{username}"',
             f'"{username}" site:pastebin.com',
@@ -288,7 +304,7 @@ def generate_google_dorks(self, username):
         return dorks
 
 def load_platforms(config_path=None):
-    """Load platforms from JSON file or use built-in."""
+    """Load platforms from JSON file or use built-in configuration."""
     if config_path and os.path.isfile(config_path):
         with open(config_path, "r") as f:
             return json.load(f)
@@ -326,40 +342,135 @@ def load_platforms(config_path=None):
             "code": [404],
             "recon_enabled": True
         },
-        "TikTok": {"url": "https://tiktok.com/@{}", "method": "response_text", "error_msg": ["Couldn't find this account"]},
-        "YouTube": {"url": "https://youtube.com/{}", "method": "response_text", "error_msg": ["This channel does not exist"]},
-        "Twitch": {"url": "https://twitch.tv/{}", "method": "status_code", "code": [404]},
-        "Facebook": {"url": "https://facebook.com/{}", "method": "response_text", "error_msg": ["This page isn't available"]},
-        "Pinterest": {"url": "https://pinterest.com/{}", "method": "response_text", "error_msg": ["Sorry, we couldn't find that page"]},
-        "Steam": {"url": "https://steamcommunity.com/id/{}", "method": "response_text", "error_msg": ["The specified profile could not be found"]},
-        "Vimeo": {"url": "https://vimeo.com/{}", "method": "response_text", "error_msg": ["Sorry, we couldn't find that user"]},
-        "SoundCloud": {"url": "https://soundcloud.com/{}", "method": "response_text", "error_msg": ["Oops! We can't find that track"]},
-        "Medium": {"url": "https://medium.com/@{}", "method": "response_text", "error_msg": ["404"]},
-        "DeviantArt": {"url": "https://{}.deviantart.com", "method": "response_text", "error_msg": ["404"]},
-        "GitLab": {"url": "https://gitlab.com/{}", "method": "status_code", "code": [404]},
-        "Bitbucket": {"url": "https://bitbucket.org/{}", "method": "status_code", "code": [404]},
-        "Keybase": {"url": "https://keybase.io/{}", "method": "status_code", "code": [404]},
-        "HackerNews": {"url": "https://news.ycombinator.com/user?id={}", "method": "response_text", "error_msg": ["No such user"]},
-        "CodePen": {"url": "https://codepen.io/{}", "method": "response_text", "error_msg": ["Sorry, couldn't find that pen"]},
-        "Telegram": {"url": "https://t.me/{}", "method": "response_text", "error_msg": ["Telegram channel not found"]},
-        "Tumblr": {"url": "https://{}.tumblr.com", "method": "response_text", "error_msg": ["Nothing here"]},
-        "Spotify": {"url": "https://open.spotify.com/user/{}", "method": "response_text", "error_msg": ["Couldn't find that user"]},
-        "Last.fm": {"url": "https://last.fm/user/{}", "method": "response_text", "error_msg": ["Page not found"]},
-        "Roblox": {"url": "https://www.roblox.com/user.aspx?username={}", "method": "response_text", "error_msg": ["404"]},
-        "Quora": {"url": "https://www.quora.com/profile/{}", "method": "response_text", "error_msg": ["Oops! The page you were looking for doesn't exist"]},
-        "VK": {"url": "https://vk.com/{}", "method": "response_text", "error_msg": ["404"]},
-        "Imgur": {"url": "https://imgur.com/user/{}", "method": "response_text", "error_msg": ["404"]},
-        "Etsy": {"url": "https://www.etsy.com/shop/{}", "method": "response_text", "error_msg": ["404"]},
-        "Pastebin": {"url": "https://pastebin.com/u/{}", "method": "response_text", "error_msg": ["404"]},
+        "TikTok": {
+            "url": "https://tiktok.com/@{}",
+            "method": "response_text",
+            "error_msg": ["Couldn't find this account"]
+        },
+        "YouTube": {
+            "url": "https://youtube.com/{}",
+            "method": "response_text",
+            "error_msg": ["This channel does not exist"]
+        },
+        "Twitch": {
+            "url": "https://twitch.tv/{}",
+            "method": "status_code",
+            "code": [404]
+        },
+        "Facebook": {
+            "url": "https://facebook.com/{}",
+            "method": "response_text",
+            "error_msg": ["This page isn't available"]
+        },
+        "Pinterest": {
+            "url": "https://pinterest.com/{}",
+            "method": "response_text",
+            "error_msg": ["Sorry, we couldn't find that page"]
+        },
+        "Steam": {
+            "url": "https://steamcommunity.com/id/{}",
+            "method": "response_text",
+            "error_msg": ["The specified profile could not be found"]
+        },
+        "Vimeo": {
+            "url": "https://vimeo.com/{}",
+            "method": "response_text",
+            "error_msg": ["Sorry, we couldn't find that user"]
+        },
+        "SoundCloud": {
+            "url": "https://soundcloud.com/{}",
+            "method": "response_text",
+            "error_msg": ["Oops! We can't find that track"]
+        },
+        "Medium": {
+            "url": "https://medium.com/@{}",
+            "method": "response_text",
+            "error_msg": ["404"]
+        },
+        "DeviantArt": {
+            "url": "https://{}.deviantart.com",
+            "method": "response_text",
+            "error_msg": ["404"]
+        },
+        "GitLab": {
+            "url": "https://gitlab.com/{}",
+            "method": "status_code",
+            "code": [404]
+        },
+        "Bitbucket": {
+            "url": "https://bitbucket.org/{}",
+            "method": "status_code",
+            "code": [404]
+        },
+        "Keybase": {
+            "url": "https://keybase.io/{}",
+            "method": "status_code",
+            "code": [404]
+        },
+        "HackerNews": {
+            "url": "https://news.ycombinator.com/user?id={}",
+            "method": "response_text",
+            "error_msg": ["No such user"]
+        },
+        "CodePen": {
+            "url": "https://codepen.io/{}",
+            "method": "response_text",
+            "error_msg": ["Sorry, couldn't find that pen"]
+        },
+        "Telegram": {
+            "url": "https://t.me/{}",
+            "method": "response_text",
+            "error_msg": ["Telegram channel not found"]
+        },
+        "Tumblr": {
+            "url": "https://{}.tumblr.com",
+            "method": "response_text",
+            "error_msg": ["Nothing here"]
+        },
+        "Spotify": {
+            "url": "https://open.spotify.com/user/{}",
+            "method": "response_text",
+            "error_msg": ["Couldn't find that user"]
+        },
+        "Last.fm": {
+            "url": "https://last.fm/user/{}",
+            "method": "response_text",
+            "error_msg": ["Page not found"]
+        },
+        "Roblox": {
+            "url": "https://www.roblox.com/user.aspx?username={}",
+            "method": "response_text",
+            "error_msg": ["404"]
+        },
+        "Quora": {
+            "url": "https://www.quora.com/profile/{}",
+            "method": "response_text",
+            "error_msg": ["Oops! The page you were looking for doesn't exist"]
+        },
+        "VK": {
+            "url": "https://vk.com/{}",
+            "method": "response_text",
+            "error_msg": ["404"]
+        },
+        "Imgur": {
+            "url": "https://imgur.com/user/{}",
+            "method": "response_text",
+            "error_msg": ["404"]
+        },
+        "Etsy": {
+            "url": "https://www.etsy.com/shop/{}",
+            "method": "response_text",
+            "error_msg": ["404"]
+        },
+        "Pastebin": {
+            "url": "https://pastebin.com/u/{}",
+            "method": "response_text",
+            "error_msg": ["404"]
+        },
     }
 
-FALLBACK_UA_LIST = [
-    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
-    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Safari/605.1.15",
-    "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
-]
-
 def get_random_user_agent():
+    """Get a random user agent string."""
     if FAKE_UA_AVAILABLE:
         try:
             return UserAgent().random
@@ -367,7 +478,9 @@ def get_random_user_agent():
             pass
     return random.choice(FALLBACK_UA_LIST)
 
+
 def get_session_with_retries(proxy=None, tor=False):
+    """Create HTTP session with retry configuration and optional proxy."""
     session = requests.Session()
     retries = Retry(total=3, backoff_factor=0.5, status_forcelist=[429, 500, 502, 503, 504])
     session.mount("https://", HTTPAdapter(max_retries=retries))
@@ -380,6 +493,7 @@ def get_session_with_retries(proxy=None, tor=False):
         "Referer": "https://www.google.com/",
         "DNT": "1",
     })
+    
     if proxy:
         session.proxies = {"http": proxy, "https": proxy}
     elif tor:
@@ -387,6 +501,7 @@ def get_session_with_retries(proxy=None, tor=False):
             "http": "socks5h://127.0.0.1:9050",
             "https": "socks5h://127.0.0.1:9050"
         }
+    
     return session
 
 def check_platform(session, username, platform, info, timeout=15, deep_scan=False):
@@ -631,20 +746,33 @@ def list_platforms(platforms):
         print(Colors.YELLOW + f"- {name} {Colors.CYAN}[Recon: {recon_status}]{Colors.RESET}")
 
 def print_result_table(results):
-    from tabulate import tabulate  # move to top if u wanto
-
-    table_data = []
-    for result in results:
-        status = (
-            "AVAILABLE" if result["available"] is True
-            else "TAKEN" if result["available"] is False
-            else "ERROR"
-        )
-        profile_url = result["url"] if result["available"] is False else "-"
-        table_data.append([result["platform"], status, profile_url])
+    """Print results in a formatted table."""
+    if TABULATE_AVAILABLE:
+        from tabulate import tabulate
+        table_data = []
+        for result in results:
+            status = (
+                "AVAILABLE" if result["available"] is True
+                else "TAKEN" if result["available"] is False
+                else "ERROR"
+            )
+            profile_url = result["url"] if result["available"] is False else "-"
+            table_data.append([result["platform"], status, profile_url])
 
-    headers = ["Platform", "Status", "Profile"]
-    print("\n" + Colors.CYAN + tabulate(table_data, headers=headers, tablefmt="github") + Colors.RESET)
+        headers = ["Platform", "Status", "Profile"]
+        print("\n" + Colors.CYAN + tabulate(table_data, headers=headers, tablefmt="github") + Colors.RESET)
+    else:
+        # Fallback to simple table if tabulate not available
+        table = Table(["Platform", "Status", "Profile"])
+        for result in results:
+            status = (
+                "AVAILABLE" if result["available"] is True
+                else "TAKEN" if result["available"] is False
+                else "ERROR"
+            )
+            profile_url = result["url"] if result["available"] is False else "-"
+            table.add_row([result["platform"], status, profile_url])
+        table.display()
 
 def generate_username_variants(username):
     """Generate leet/fuzzy variants of a username."""
@@ -719,7 +847,9 @@ def add_numbers(s):
 
     # Remove original username and deduplicate
     variants.discard(username)
-    # Start with initial username
+    
+    # Use a queue for breadth-first generation to avoid exponential growth
+    queue = deque()
     queue.append(username)
     seen = set([username])
 
@@ -1025,35 +1155,7 @@ def prompt_platform_selection(platforms):
     return selected
 
 def run_metadata_extraction(confirmed_hits, platforms):
-    count = len(confirmed_hits)
-    platform_url_pairs = [(p, url) for p, url in confirmed_hits.items()]
-    # Interactive logic
-    if count <= 5:
-        print(Colors.GREEN + f"[+] Metadata extraction detected for up to {count} platforms." + Colors.RESET)
-        ans = input("Do you want to add extra custom platform URL(s) to check? [y/n]: ").strip().lower()
-        custom_urls = []
-        if ans == "y":
-            custom_urls = prompt_custom_urls()
-        for url in custom_urls:
-            platform_url_pairs.append((url, url))
-    else:
-        print(Colors.YELLOW + "[-] Metadata extraction may take extra time depending on platform speed and rate limits." + Colors.RESET)
-        ans = input("Proceed with all platforms? [y/n]: ").strip().lower()
-        if ans == "y":
-            pass  # use all
-        else:
-            selected = prompt_platform_selection(list(confirmed_hits.keys()))
-            platform_url_pairs = [(p, confirmed_hits[p]) for p in selected]
-            custom_urls = prompt_custom_urls()
-            for url in custom_urls:
-                platform_url_pairs.append((url, url))
-    print(Colors.MAGENTA + "\n[+] Starting metadata extraction...\n" + Colors.RESET)
-    # Run asyncio event loop for metadata extraction
-    loop = asyncio.get_event_loop()
-    meta_results = asyncio.run(extract_metadata_async(platform_url_pairs))
-    display_metadata_table(meta_results)
-# (Function run_metadata_extraction removed as it was unused and duplicated logic.)
-def run_metadata_extraction_interactive(confirmed_hits, platforms):
+    """Run metadata extraction with interactive platform selection."""
     count = len(confirmed_hits)
     platform_url_pairs = []
     custom_urls = []
@@ -1094,9 +1196,11 @@ def run_metadata_extraction_interactive(confirmed_hits, platforms):
                 print(Colors.RED + "[!] Invalid choice. Type 'y' for yes or 'n' to cancel." + Colors.RESET)
 
     print(Colors.MAGENTA + "\n[+] Starting metadata extraction...\n" + Colors.RESET)
-    loop = asyncio.get_event_loop()
-    meta_results = asyncio.run(extract_metadata_async(platform_url_pairs))
-    display_metadata_table(meta_results)
+    try:
+        meta_results = asyncio.run(extract_metadata_async(platform_url_pairs))
+        display_metadata_table(meta_results)
+    except Exception as e:
+        print(Colors.RED + f"[!] Error during metadata extraction: {e}" + Colors.RESET)
 
 def main():
     parser = argparse.ArgumentParser(description="USRLINKS - OSINT Username Hunter")
@@ -1190,7 +1294,7 @@ def main():
     # Metadata extraction logic (interactive, after showing results)
     if getattr(args, "metadata", False):
         confirmed_hits = {r["platform"]: r["url"] for r in results if r["available"] is False or (r["available"] is None and r.get("url"))}
-        run_metadata_extraction_interactive(confirmed_hits, platforms)
+        run_metadata_extraction(confirmed_hits, platforms)
 
     # Fuzzy scan last if requested
     if args.fuzzy:
diff --git a/usrlinks.sh b/usrlinks.sh
index a3d06ca1a..ba8150cd1 100755
--- a/usrlinks.sh
+++ b/usrlinks.sh
@@ -1,8 +1,5 @@
 #!/bin/bash
 
-# USRLINKS Simple Launcher
-# Usage: ./usrlinks.sh -u username [options]
-
 # Colors for output
 RED='\033[0;31m'
 GREEN='\033[0;32m'

From 41528c5e42de24c138ea362424a49dcaa94a21dd Mon Sep 17 00:00:00 2001
From: alex <wh1t3h4t@kali>
Date: Mon, 6 Oct 2025 09:16:07 +0300
Subject: [PATCH 19/19] Deleted three files

---
 USRLINKS_alex_20250920_045943.json            | 275 ------------------
 .../USRLINKS_Report_alex_20250920_045931.html | 236 ---------------
 usrlinks.log                                  |   0
 3 files changed, 511 deletions(-)
 delete mode 100644 USRLINKS_alex_20250920_045943.json
 delete mode 100644 results/USRLINKS_Report_alex_20250920_045931.html
 delete mode 100644 usrlinks.log

diff --git a/USRLINKS_alex_20250920_045943.json b/USRLINKS_alex_20250920_045943.json
deleted file mode 100644
index d34db69cd..000000000
--- a/USRLINKS_alex_20250920_045943.json
+++ /dev/null
@@ -1,275 +0,0 @@
-[
-  {
-    "platform": "YouTube",
-    "url": "https://youtube.com/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Twitter",
-    "url": "https://twitter.com/alex",
-    "available": false,
-    "recon_data": {
-      "contact_info": {
-        "emails": [],
-        "phones": [
-          "2025"
-        ],
-        "urls": [],
-        "location": null,
-        "bio": null,
-        "name": null,
-        "verified": false
-      },
-      "profile_image": {
-        "url": null,
-        "hash": null,
-        "downloaded": false
-      }
-    }
-  },
-  {
-    "platform": "LinkedIn",
-    "url": "https://linkedin.com/in/alex",
-    "available": false,
-    "recon_data": {
-      "contact_info": {
-        "emails": [],
-        "phones": [
-          "2015",
-          "2019",
-          "2023",
-          "2016",
-          "2025"
-        ],
-        "urls": [
-          "www.curated.com",
-          "https://www.curated.com/careers",
-          "www.curated.com/careers",
-          "https://www.curated.com"
-        ],
-        "location": null,
-        "bio": null,
-        "name": null,
-        "verified": false
-      },
-      "profile_image": {
-        "url": null,
-        "hash": null,
-        "downloaded": false
-      }
-    }
-  },
-  {
-    "platform": "Twitch",
-    "url": "https://twitch.tv/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "TikTok",
-    "url": "https://tiktok.com/@alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Facebook",
-    "url": "https://facebook.com/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Instagram",
-    "url": "https://instagram.com/alex",
-    "available": false,
-    "recon_data": {
-      "contact_info": {
-        "emails": [],
-        "phones": [],
-        "urls": [],
-        "location": null,
-        "bio": null,
-        "name": null,
-        "verified": false
-      },
-      "profile_image": {
-        "url": null,
-        "hash": null,
-        "downloaded": false
-      }
-    }
-  },
-  {
-    "platform": "Reddit",
-    "url": "https://reddit.com/user/alex",
-    "available": false,
-    "recon_data": {
-      "contact_info": {
-        "emails": [],
-        "phones": [],
-        "urls": [],
-        "location": null,
-        "bio": null,
-        "name": null,
-        "verified": false
-      },
-      "profile_image": {
-        "url": null,
-        "hash": null,
-        "downloaded": false
-      }
-    }
-  },
-  {
-    "platform": "Steam",
-    "url": "https://steamcommunity.com/id/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "GitHub",
-    "url": "https://github.com/alex",
-    "available": false,
-    "recon_data": {
-      "contact_info": {
-        "emails": [],
-        "phones": [
-          "2020",
-          "2025"
-        ],
-        "urls": [
-          "https://alexgaynor.net"
-        ],
-        "location": "Washington D.C.",
-        "bio": "I program computers, and build teams that program computers, with a heavy focus on security.",
-        "name": "Alex Gaynor",
-        "verified": false
-      },
-      "profile_image": {
-        "url": "https://avatars.githubusercontent.com/u/772?s=64&v=4",
-        "hash": "b0030b738edc295b14e5c237f4649bfe",
-        "downloaded": false
-      }
-    }
-  },
-  {
-    "platform": "Vimeo",
-    "url": "https://vimeo.com/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "SoundCloud",
-    "url": "https://soundcloud.com/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Telegram",
-    "url": "https://t.me/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Medium",
-    "url": "https://medium.com/@alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "GitLab",
-    "url": "https://gitlab.com/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "CodePen",
-    "url": "https://codepen.io/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Keybase",
-    "url": "https://keybase.io/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Bitbucket",
-    "url": "https://bitbucket.org/alex",
-    "available": true,
-    "recon_data": {}
-  },
-  {
-    "platform": "HackerNews",
-    "url": "https://news.ycombinator.com/user?id=alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "DeviantArt",
-    "url": "https://alex.deviantart.com",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Pinterest",
-    "url": "https://pinterest.com/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Tumblr",
-    "url": "https://alex.tumblr.com",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Quora",
-    "url": "https://www.quora.com/profile/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Spotify",
-    "url": "https://open.spotify.com/user/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Imgur",
-    "url": "https://imgur.com/user/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "VK",
-    "url": "https://vk.com/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Last.fm",
-    "url": "https://last.fm/user/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Pastebin",
-    "url": "https://pastebin.com/u/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Etsy",
-    "url": "https://www.etsy.com/shop/alex",
-    "available": false,
-    "recon_data": {}
-  },
-  {
-    "platform": "Roblox",
-    "url": "https://www.roblox.com/user.aspx?username=alex",
-    "available": true,
-    "recon_data": {}
-  }
-]
\ No newline at end of file
diff --git a/results/USRLINKS_Report_alex_20250920_045931.html b/results/USRLINKS_Report_alex_20250920_045931.html
deleted file mode 100644
index f3e6ac68d..000000000
--- a/results/USRLINKS_Report_alex_20250920_045931.html
+++ /dev/null
@@ -1,236 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>USRLINKS Report - alex</title>
-    <style>
-        body {
-            font-family: 'Arial', sans-serif;
-            line-height: 1.6;
-            color: #e0e0e0;
-            max-width: 1200px;
-            margin: 0 auto;
-            padding: 20px;
-            background: linear-gradient(135deg, #1a1a1a 0%, #2d2d2d 100%);
-            min-height: 100vh;
-        }
-        .container {
-            background: #333;
-            border-radius: 15px;
-            box-shadow: 0 10px 30px rgba(0,0,0,0.5);
-            padding: 30px;
-        }
-        .header {
-            text-align: center;
-            margin-bottom: 30px;
-            padding: 20px;
-            background: linear-gradient(45deg, #444, #555);
-            color: #fff;
-            border-radius: 10px;
-        }
-        .header h1 {
-            margin: 0;
-            font-size: 2.5em;
-            text-shadow: 2px 2px 4px rgba(0,0,0,0.5);
-        }
-        .summary {
-            display: grid;
-            grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
-            gap: 15px;
-            margin: 20px 0;
-        }
-        .summary-card {
-            background: #444;
-            padding: 15px;
-            border-radius: 8px;
-            text-align: center;
-            border-left: 4px solid #667eea;
-            color: #e0e0e0;
-        }
-        .summary-number {
-            font-size: 2em;
-            font-weight: bold;
-            color: #667eea;
-        }
-        .results-table {
-            width: 100%;
-            border-collapse: collapse;
-            margin: 20px 0;
-            box-shadow: 0 2px 10px rgba(0,0,0,0.3);
-        }
-        .results-table th,
-        .results-table td {
-            padding: 12px;
-            text-align: left;
-            border-bottom: 1px solid #555;
-        }
-        .results-table th {
-            background: linear-gradient(45deg, #444, #555);
-            color: #fff;
-        }
-        .results-table tr:hover {
-            background-color: #444;
-        }
-        .status-available {
-            color: #28a745;
-            font-weight: bold;
-        }
-        .status-taken {
-            color: #dc3545;
-            font-weight: bold;
-        }
-        .status-error {
-            color: #ffc107;
-            font-weight: bold;
-        }
-        .recon-section {
-            margin: 20px 0;
-            padding: 20px;
-            background: #444;
-            border-radius: 8px;
-            border-left: 4px solid #28a745;
-            color: #e0e0e0;
-        }
-        .footer {
-            text-align: center;
-            margin-top: 30px;
-            padding: 20px;
-            background: #444;
-            border-radius: 8px;
-            color: #aaa;
-        }
-        .url-link {
-            color: #667eea;
-            text-decoration: none;
-        }
-        .url-link:hover {
-            text-decoration: underline;
-        }
-        .recon-item {
-            background: #333;
-            margin: 10px 0;
-            padding: 15px;
-            border-radius: 5px;
-            border-left: 3px solid #17a2b8;
-            color: #e0e0e0;
-        }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <div class="header">
-            <h1>🔍 USRLINKS Report</h1>
-            <h2>Username: alex</h2>
-            <p>Generated on Sat Sep 20 04:59:43 AM EAT 2025</p>
-        </div>
-
-        <div id="summary" class="summary">
-            <!-- Summary will be populated by JavaScript -->
-        </div>
-
-        <table class="results-table">
-            <thead>
-                <tr>
-                    <th>Platform</th>
-                    <th>Status</th>
-                    <th>URL</th>
-                    <th>Action</th>
-                </tr>
-            </thead>
-            <tbody id="results-body">
-                <!-- Results will be populated by JavaScript -->
-            </tbody>
-        </table>
-
-        <div id="recon-data" class="recon-section" style="display: none;">
-            <h3>🕵️ Reconnaissance Data</h3>
-            <div id="recon-content"></div>
-        </div>
-
-        <div class="footer">
-            <p><strong>USRLINKS</strong> - OSINT Username Hunter</p>
-            <p>Scan completed at Sat Sep 20 04:59:43 AM EAT 2025</p>
-        </div>
-    </div>
-
-    <script>
-        // Load JSON data
-        const results = [{"platform": "YouTube", "url": "https://youtube.com/alex", "available": false, "recon_data": {}}, {"platform": "Twitter", "url": "https://twitter.com/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": ["2025"], "urls": [], "location": null, "bio": null, "name": null, "verified": false}, "profile_image": {"url": null, "hash": null, "downloaded": false}}}, {"platform": "LinkedIn", "url": "https://linkedin.com/in/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": ["2015", "2019", "2023", "2016", "2025"], "urls": ["www.curated.com", "https://www.curated.com/careers", "www.curated.com/careers", "https://www.curated.com"], "location": null, "bio": null, "name": null, "verified": false}, "profile_image": {"url": null, "hash": null, "downloaded": false}}}, {"platform": "Twitch", "url": "https://twitch.tv/alex", "available": false, "recon_data": {}}, {"platform": "TikTok", "url": "https://tiktok.com/@alex", "available": false, "recon_data": {}}, {"platform": "Facebook", "url": "https://facebook.com/alex", "available": false, "recon_data": {}}, {"platform": "Instagram", "url": "https://instagram.com/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": [], "urls": [], "location": null, "bio": null, "name": null, "verified": false}, "profile_image": {"url": null, "hash": null, "downloaded": false}}}, {"platform": "Reddit", "url": "https://reddit.com/user/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": [], "urls": [], "location": null, "bio": null, "name": null, "verified": false}, "profile_image": {"url": null, "hash": null, "downloaded": false}}}, {"platform": "Steam", "url": "https://steamcommunity.com/id/alex", "available": false, "recon_data": {}}, {"platform": "GitHub", "url": "https://github.com/alex", "available": false, "recon_data": {"contact_info": {"emails": [], "phones": ["2020", "2025"], "urls": ["https://alexgaynor.net"], "location": "Washington D.C.", "bio": "I program computers, and build teams that program computers, with a heavy focus on security.", "name": "Alex Gaynor", "verified": false}, "profile_image": {"url": "https://avatars.githubusercontent.com/u/772?s=64&v=4", "hash": "b0030b738edc295b14e5c237f4649bfe", "downloaded": false}}}, {"platform": "Vimeo", "url": "https://vimeo.com/alex", "available": false, "recon_data": {}}, {"platform": "SoundCloud", "url": "https://soundcloud.com/alex", "available": false, "recon_data": {}}, {"platform": "Telegram", "url": "https://t.me/alex", "available": false, "recon_data": {}}, {"platform": "Medium", "url": "https://medium.com/@alex", "available": false, "recon_data": {}}, {"platform": "GitLab", "url": "https://gitlab.com/alex", "available": false, "recon_data": {}}, {"platform": "CodePen", "url": "https://codepen.io/alex", "available": false, "recon_data": {}}, {"platform": "Keybase", "url": "https://keybase.io/alex", "available": false, "recon_data": {}}, {"platform": "Bitbucket", "url": "https://bitbucket.org/alex", "available": true, "recon_data": {}}, {"platform": "HackerNews", "url": "https://news.ycombinator.com/user?id=alex", "available": false, "recon_data": {}}, {"platform": "DeviantArt", "url": "https://alex.deviantart.com", "available": false, "recon_data": {}}, {"platform": "Pinterest", "url": "https://pinterest.com/alex", "available": false, "recon_data": {}}, {"platform": "Tumblr", "url": "https://alex.tumblr.com", "available": false, "recon_data": {}}, {"platform": "Quora", "url": "https://www.quora.com/profile/alex", "available": false, "recon_data": {}}, {"platform": "Spotify", "url": "https://open.spotify.com/user/alex", "available": false, "recon_data": {}}, {"platform": "Imgur", "url": "https://imgur.com/user/alex", "available": false, "recon_data": {}}, {"platform": "VK", "url": "https://vk.com/alex", "available": false, "recon_data": {}}, {"platform": "Last.fm", "url": "https://last.fm/user/alex", "available": false, "recon_data": {}}, {"platform": "Pastebin", "url": "https://pastebin.com/u/alex", "available": false, "recon_data": {}}, {"platform": "Etsy", "url": "https://www.etsy.com/shop/alex", "available": false, "recon_data": {}}, {"platform": "Roblox", "url": "https://www.roblox.com/user.aspx?username=alex", "available": true, "recon_data": {}}];
-        
-        // Calculate summary statistics
-        let available = 0, taken = 0, errors = 0;
-        results.forEach(result => {
-            if (result.available === true) available++;
-            else if (result.available === false) taken++;
-            else errors++;
-        });
-
-        // Populate summary
-        document.getElementById('summary').innerHTML = `
-            <div class="summary-card">
-                <div class="summary-number">${available}</div>
-                <div>Available</div>
-            </div>
-            <div class="summary-card">
-                <div class="summary-number">${taken}</div>
-                <div>Taken</div>
-            </div>
-            <div class="summary-card">
-                <div class="summary-number">${errors}</div>
-                <div>Errors</div>
-            </div>
-            <div class="summary-card">
-                <div class="summary-number">${results.length}</div>
-                <div>Total Platforms</div>
-            </div>
-        `;
-
-        // Populate results table
-        const tbody = document.getElementById('results-body');
-        results.sort((a, b) => a.platform.localeCompare(b.platform)).forEach(result => {
-            const row = document.createElement('tr');
-            
-            let statusClass = 'status-error';
-            let statusText = 'ERROR';
-            let actionButton = '';
-            
-            if (result.available === true) {
-                statusClass = 'status-available';
-                statusText = '✅ AVAILABLE';
-                actionButton = `<a href="${result.url}" target="_blank" class="url-link">Visit</a>`;
-            } else if (result.available === false) {
-                statusClass = 'status-taken';
-                statusText = '❌ TAKEN';
-                actionButton = `<a href="${result.url}" target="_blank" class="url-link">View Profile</a>`;
-            }
-            
-            row.innerHTML = `
-                <td><strong>${result.platform}</strong></td>
-                <td class="${statusClass}">${statusText}</td>
-                <td><a href="${result.url}" target="_blank" class="url-link">${result.url}</a></td>
-                <td>${actionButton}</td>
-            `;
-            tbody.appendChild(row);
-        });
-
-        // Check for reconnaissance data
-        const hasReconData = results.some(r => r.recon_data && Object.keys(r.recon_data).length > 0);
-        if (hasReconData) {
-            document.getElementById('recon-data').style.display = 'block';
-            let reconHtml = '<h4>🔍 Deep Scan Results</h4>';
-            
-            results.forEach(result => {
-                if (result.recon_data && Object.keys(result.recon_data).length > 0) {
-                    reconHtml += `<div class="recon-item">
-                        <h5>${result.platform}</h5>
-                        <pre style="background: #f8f9fa; padding: 10px; border-radius: 3px; overflow-x: auto;">${JSON.stringify(result.recon_data, null, 2)}</pre>
-                    </div>`;
-                }
-            });
-            
-            document.getElementById('recon-content').innerHTML = reconHtml;
-        }
-    </script>
-</body>
-</html>
diff --git a/usrlinks.log b/usrlinks.log
deleted file mode 100644
index e69de29bb..000000000