ShadowB 0.1__tar.gz

shadowb-0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adem mzoughi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

shadowb-0.1/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.1
+Name: ShadowB
+Version: 0.1
+Summary: ShadowB is an all-in-one Python toolkit that bundles a wide range of everyday utilities — system info, image steganography, temporary email, QR codes, CAPTCHA generation, password tools, file safety checks, and more — into a single, easy-to-import package.
+Author-email: Adem mzoughi <ademzoughi1312@gmail.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# ShadowB
+
+**ShadowB** is an all-in-one Python toolkit that bundles a wide range of everyday utilities — system info, image steganography, temporary email, QR codes, CAPTCHA generation, password tools, file safety checks, and more — into a single, easy-to-import package.
+
+Instead of installing and learning a dozen different libraries for a dozen small tasks, `ShadowB` collects the most commonly needed helper functions in one place.
+
+> 100% open source. No telemetry, no analytics, no external server. Every function runs **locally** on the user's own machine — nothing is collected or transmitted by the library's maintainers.
+
+---
+
+## Installation
+
+```bash
+pip install ShadowB
+```
+
+---
+
+## Table of Contents
+
+- [core](#core)
+- [getD](#getd)
+- [search](#search)
+- [captcha](#captcha)
+- [qrcode](#qrcode)
+- [mail](#mail)
+- [safe](#safe)
+- [image](#image)
+- [passwords](#passwords)
+- [Responsible Use](#-responsible-use)
+- [License](#-license)
+
+---
+
+## `core`
+
+Basic package metadata and bootstrapping.
+
+```python
+from ShadowB import core
+
+core.start()        # run core app fro : create passwords or usernames / organize the working files
+core.owner()        # -> "Adem mzoughi"
+core.team()         # -> "Adem mzoughi, Berlin, Shadow"
+core.hp()           # print help / usage info
+core.vr()           # print current version
+```
+
+---
+
+## `getD`
+
+Local system & network diagnostics — useful for things like monitoring your own machine's load, debugging your own network setup, or quick scripting.
+
+```python
+from ShadowB import getD
+
+getD.my_ip()             # your public IP address
+getD.my_data()           # IP, country, and basic PC specs (CPU/RAM, etc.)
+getD.get_cookies(filename)   # export your own browser's cookies to a local .txt file
+getD.scan_open_ports()    # check which ports are open on a given website
+getD.whm()                # print the current working directory (e.g. C:/Users/Pc/Desktop)
+```
+
+> ⚠️ `get_cookies()` reads cookies from **your own** browser profile and `scan_open_ports()` should only be run against hosts you own or are authorized to test. See [Responsible Use](#-responsible-use).
+
+---
+
+## `search`
+
+Look up whether a username exists on a given platform.
+
+```python
+from ShadowB import search
+
+search.forgot.search_by_username(app, username)
+# returns True (and prints the profile link) or False
+# app: ".insta" | ".fc" | ".yt"
+```
+
+---
+
+## `captcha`
+
+Generate CAPTCHA images.
+
+```python
+from ShadowB import captcha
+
+captcha.generate_captcha("captcha") # image name
+```
+
+---
+
+## `qrcode`
+
+Generate and read QR codes.
+
+```python
+from ShadowB import qrcode
+
+qrcode.generate_qrcode(text, "qr")   # create a QR code image
+qrcode.scan_qrcode("qr.png")             # -> decoded text (str)
+```
+
+---
+
+## `mail`
+
+Disposable email creation and sending (Gmail SMTP).
+
+```python
+from ShadowB import mail
+
+mail.create_email()                      # -> email, password, token
+mail.get_msj(token)                      # -> list of received messages (id, subject, body, ...)
+mail.send_msj(sender, app_password, to, subject, body)   # send via Gmail SMTP
+```
+
+---
+
+## `safe`
+
+File inspection and sanitation helpers.
+
+```python
+from ShadowB import safe
+
+safe.safeFile(file)              # -> True / False
+safe.size(file)                  # -> file size
+safe.name(file)                  # -> file name
+safe.ext(file)                   # -> file extension
+safe.clean(file, check_list)     # -> True / False
+safe.cleanText(text, check_list) # -> True / False
+```
+
+---
+
+## `image`
+
+Metadata and steganography utilities.
+
+```python
+from ShadowB import image
+
+image.expMetadata(img)          # read EXIF / metadata
+image.check_img(img)            # -> True / False (contains hidden text/file)
+image.extr_file(img)            # extract a hidden file from the image
+image.extr_text(img)            # extract hidden text from the image
+image.removeMetadata(img)       # strip metadata (useful before sharing photos)
+image.hide_text(img, text)      # embed hidden text into the image
+image.hide_file(img, file)      # embed a hidden file into the image
+```
+
+---
+
+## `passwords`
+
+```python
+from ShadowB import passwords
+
+passwords.check_strenght(password)   # rate password strength
+passwords.create_password()          # generate a strong password
+```
+
+---
+
+## ⚖️ Responsible Use
+
+`ShadowB` is a general-purpose utility library, similar in spirit to combining tools like `requests`, `browser_cookie3`, `psutil`, `python-nmap`, and `Pillow`-based steganography helpers into one package. It performs no network exfiltration on its own and contacts no third-party server.
+
+That said, several functions are powerful and should be used responsibly:
+
+- Only run `get_cookies()` against your **own** browser profile.
+- Only use `scan_open_ports()` on systems/websites you **own** or are explicitly authorized to test.
+- Respect each platform's Terms of Service and applicable privacy laws when using `search.forgot.search_by_username`.
+- Don't use the steganography functions (`hide_text`, `hide_file`) to conceal malicious payloads or to deceive other people.
+
+You are responsible for complying with local laws and the terms of any service you interact with through this library.
+
+---
+
+## 📄 License
+
+This project is licensed under the [MIT License](./LICENSE).
+
+---
+
+## 👤 Author
+
+**Adem mzoughi** — 2026/23/06

shadowb-0.1/README.md

@@ -0,0 +1,191 @@
+# ShadowB
+
+**ShadowB** is an all-in-one Python toolkit that bundles a wide range of everyday utilities — system info, image steganography, temporary email, QR codes, CAPTCHA generation, password tools, file safety checks, and more — into a single, easy-to-import package.
+
+Instead of installing and learning a dozen different libraries for a dozen small tasks, `ShadowB` collects the most commonly needed helper functions in one place.
+
+> 100% open source. No telemetry, no analytics, no external server. Every function runs **locally** on the user's own machine — nothing is collected or transmitted by the library's maintainers.
+
+---
+
+## Installation
+
+```bash
+pip install ShadowB
+```
+
+---
+
+## Table of Contents
+
+- [core](#core)
+- [getD](#getd)
+- [search](#search)
+- [captcha](#captcha)
+- [qrcode](#qrcode)
+- [mail](#mail)
+- [safe](#safe)
+- [image](#image)
+- [passwords](#passwords)
+- [Responsible Use](#-responsible-use)
+- [License](#-license)
+
+---
+
+## `core`
+
+Basic package metadata and bootstrapping.
+
+```python
+from ShadowB import core
+
+core.start()        # run core app fro : create passwords or usernames / organize the working files
+core.owner()        # -> "Adem mzoughi"
+core.team()         # -> "Adem mzoughi, Berlin, Shadow"
+core.hp()           # print help / usage info
+core.vr()           # print current version
+```
+
+---
+
+## `getD`
+
+Local system & network diagnostics — useful for things like monitoring your own machine's load, debugging your own network setup, or quick scripting.
+
+```python
+from ShadowB import getD
+
+getD.my_ip()             # your public IP address
+getD.my_data()           # IP, country, and basic PC specs (CPU/RAM, etc.)
+getD.get_cookies(filename)   # export your own browser's cookies to a local .txt file
+getD.scan_open_ports()    # check which ports are open on a given website
+getD.whm()                # print the current working directory (e.g. C:/Users/Pc/Desktop)
+```
+
+> ⚠️ `get_cookies()` reads cookies from **your own** browser profile and `scan_open_ports()` should only be run against hosts you own or are authorized to test. See [Responsible Use](#-responsible-use).
+
+---
+
+## `search`
+
+Look up whether a username exists on a given platform.
+
+```python
+from ShadowB import search
+
+search.forgot.search_by_username(app, username)
+# returns True (and prints the profile link) or False
+# app: ".insta" | ".fc" | ".yt"
+```
+
+---
+
+## `captcha`
+
+Generate CAPTCHA images.
+
+```python
+from ShadowB import captcha
+
+captcha.generate_captcha("captcha") # image name
+```
+
+---
+
+## `qrcode`
+
+Generate and read QR codes.
+
+```python
+from ShadowB import qrcode
+
+qrcode.generate_qrcode(text, "qr")   # create a QR code image
+qrcode.scan_qrcode("qr.png")             # -> decoded text (str)
+```
+
+---
+
+## `mail`
+
+Disposable email creation and sending (Gmail SMTP).
+
+```python
+from ShadowB import mail
+
+mail.create_email()                      # -> email, password, token
+mail.get_msj(token)                      # -> list of received messages (id, subject, body, ...)
+mail.send_msj(sender, app_password, to, subject, body)   # send via Gmail SMTP
+```
+
+---
+
+## `safe`
+
+File inspection and sanitation helpers.
+
+```python
+from ShadowB import safe
+
+safe.safeFile(file)              # -> True / False
+safe.size(file)                  # -> file size
+safe.name(file)                  # -> file name
+safe.ext(file)                   # -> file extension
+safe.clean(file, check_list)     # -> True / False
+safe.cleanText(text, check_list) # -> True / False
+```
+
+---
+
+## `image`
+
+Metadata and steganography utilities.
+
+```python
+from ShadowB import image
+
+image.expMetadata(img)          # read EXIF / metadata
+image.check_img(img)            # -> True / False (contains hidden text/file)
+image.extr_file(img)            # extract a hidden file from the image
+image.extr_text(img)            # extract hidden text from the image
+image.removeMetadata(img)       # strip metadata (useful before sharing photos)
+image.hide_text(img, text)      # embed hidden text into the image
+image.hide_file(img, file)      # embed a hidden file into the image
+```
+
+---
+
+## `passwords`
+
+```python
+from ShadowB import passwords
+
+passwords.check_strenght(password)   # rate password strength
+passwords.create_password()          # generate a strong password
+```
+
+---
+
+## ⚖️ Responsible Use
+
+`ShadowB` is a general-purpose utility library, similar in spirit to combining tools like `requests`, `browser_cookie3`, `psutil`, `python-nmap`, and `Pillow`-based steganography helpers into one package. It performs no network exfiltration on its own and contacts no third-party server.
+
+That said, several functions are powerful and should be used responsibly:
+
+- Only run `get_cookies()` against your **own** browser profile.
+- Only use `scan_open_ports()` on systems/websites you **own** or are explicitly authorized to test.
+- Respect each platform's Terms of Service and applicable privacy laws when using `search.forgot.search_by_username`.
+- Don't use the steganography functions (`hide_text`, `hide_file`) to conceal malicious payloads or to deceive other people.
+
+You are responsible for complying with local laws and the terms of any service you interact with through this library.
+
+---
+
+## 📄 License
+
+This project is licensed under the [MIT License](./LICENSE).
+
+---
+
+## 👤 Author
+
+**Adem mzoughi** — 2026/23/06

shadowb-0.1/ShadowB/Core/fileorg.py

@@ -0,0 +1,38 @@
+import os
+import shutil
+
+def florg(folder=None):
+    if folder is None:
+        return "The folder path is required!"
+    types = {
+        ".jpg": "Images", ".png": "Images", ".jpeg": "Images",
+        ".zip": "Archives", ".rar": "Archives",
+        ".pdf": "Documents", ".docx": "Documents", ".txt": "Documents",
+        ".mp3": "Music", ".wav": "Music",
+        ".py": "Code", ".js": "Code", ".html": "Code",
+        ".exe": "Code", ".cpp": "Code", ".css": "Code"
+    }
+
+
+    skip_folders = set(types.values())
+
+    for root, dirs, files in os.walk(folder):
+
+        dirs[:] = [d for d in dirs if d not in skip_folders]
+
+        moved = 0
+        for file in files:
+            path = os.path.join(root, file)
+            ext = os.path.splitext(file)[1].lower()
+            if ext in types:
+                target_folder = os.path.join(root, types[ext])
+                os.makedirs(target_folder, exist_ok=True)
+                shutil.move(path, os.path.join(target_folder, file))
+                print(f"{file} → {root}/{types[ext]}/")
+                moved += 1
+            else:
+                print(f"Unknown extension: {file}")
+
+        if moved > 0:
+            print(f"\n Your files have been organized successfully: {root}\n")
+

shadowb-0.1/ShadowB/Core/randwords.py

@@ -0,0 +1,76 @@
+import string
+from random import choice
+import itertools as ito
+from pathlib import Path
+
+
+def randw(filename,rep,others_chars,numbers,symbols,letters,form):
+    if numbers and symbols and letters:
+        if form == "maj":
+            final_combo = string.ascii_uppercase + string.digits + string.punctuation + others_chars
+        elif form == "min":
+            final_combo = string.ascii_lowercase + string.digits + string.punctuation + others_chars
+        else:
+            final_combo = string.ascii_letters + string.digits + string.punctuation + others_chars
+           
+           
+    # numbers       
+    elif numbers and symbols and not letters:
+        final_combo =  string.digits + string.punctuation + others_chars
+
+    elif numbers and not symbols and letters:
+        if form == "maj":
+            final_combo = string.ascii_uppercase + string.digits + others_chars
+        elif form == "min":
+            final_combo = string.ascii_lowercase + string.digits + others_chars
+        else:
+            final_combo = string.ascii_letters + string.digits + others_chars
+        
+    elif numbers and not symbols and not letters:
+        final_combo = string.digits
+        
+        
+    # letters    
+    elif letters and symbols and not numbers:
+        if form == "maj":
+            final_combo = string.ascii_uppercase + string.punctuation + others_chars
+        elif form == "min":
+            final_combo = string.ascii_lowercase + string.punctuation + others_chars
+        else:
+            final_combo = string.ascii_letters + string.punctuation + others_chars
+            
+            
+    elif letters and not symbols and not numbers:
+        if form == "maj":
+            final_combo = string.ascii_uppercase 
+        elif form == "min":
+            final_combo = string.ascii_lowercase 
+        else:
+            final_combo = string.ascii_letters
+            
+    
+    #symbols
+    elif symbols and not letters and not numbers:
+        if form == "maj":
+            final_combo = string.punctuation + others_chars
+        elif form == "min":
+            final_combo = string.punctuation + others_chars
+        else:
+            final_combo = string.punctuation + others_chars
+            
+    else:
+        final_combo = string.ascii_letters + string.digits + string.punctuation + others_chars
+    
+    
+    final_combo = string.ascii_letters + string.digits + someCaracters + others_chars
+    if rep > 5:
+        print("The maximum number of slots you can reach is 5")
+    if rep < 2:
+        print("The smallest number of digits possible is 2")
+    desktop = Path.home() / "Desktop"
+    words = [''.join(combo) for combo in ito.product(final_combo, repeat=rep)]
+    with open(desktop / f"{filename}.txt","w") as w:
+        for wr in words:
+            w.write(wr + "\n")
+        print(f"Alright, it has been saved in : {desktop / (filename + '.txt')}")
+         

shadowb-0.1/ShadowB/GetD/make_cookies.py

@@ -0,0 +1,27 @@
+import os
+try:
+    import browser_cookie3
+except ImportError:
+    import os
+    os.system("pip install browser_cookie3")
+    import browser_cookie3
+
+
+def cookies(filename):
+    cookies = browser_cookie3.chrome()
+
+
+    with open(f"{filename}.txt", "w", encoding="utf-8") as f:
+        f.write("# Netscape HTTP Cookie File\n")
+        f.write("# This is a generated file! Do not edit.\n\n")
+        
+        for cookie in cookies:
+       
+            is_secure = "TRUE" if cookie.secure else "FALSE"
+            expiration = str(int(cookie.expires)) if cookie.expires else "0"
+            
+            line = f"{cookie.domain}\t{is_secure}\t{cookie.path}\t{is_secure}\t{expiration}\t{cookie.name}\t{cookie.value}\n"
+            f.write(line)
+    
+    print(f"Saved at : {filename}.txt and cookies") 
+    return cookies

shadowb-0.1/ShadowB/GetD/my_data.py

@@ -0,0 +1,86 @@
+import platform
+import socket
+import os
+import shutil
+import ctypes
+import getpass
+
+
+def make_file():
+    
+    data = []
+
+    data.append("=== Device Information ===\n")
+
+    username = getpass.getuser()  
+
+
+
+
+    data.append(username)
+
+    hostname = socket.gethostname()
+    data.append(f"Hostname: {hostname}\n")
+
+
+    try:
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(("8.8.8.8", 80))
+        local_ip = s.getsockname()[0]
+        s.close()
+    except:
+        local_ip = "Not available"
+    data.append(f"Local IP: {local_ip}\n")
+
+
+    os_name = platform.system()
+    os_release = platform.release()
+    arch = platform.architecture()[0]
+    data.append(f"Operating System: {os_name} {os_release}\n")
+    data.append(f"Architecture: {arch}\n")
+
+
+    class MEMORYSTATUSEX(ctypes.Structure):
+        _fields_ = [
+            ("dwLength", ctypes.c_ulong),
+            ("dwMemoryLoad", ctypes.c_ulong),
+            ("ullTotalPhys", ctypes.c_ulonglong),
+            ("ullAvailPhys", ctypes.c_ulonglong),
+            ("ullTotalPageFile", ctypes.c_ulonglong),
+            ("ullAvailPageFile", ctypes.c_ulonglong),
+            ("ullTotalVirtual", ctypes.c_ulonglong),
+            ("ullAvailVirtual", ctypes.c_ulonglong),
+            ("sullAvailExtendedVirtual", ctypes.c_ulonglong),
+        ]
+
+        def __init__(self):
+            super(MEMORYSTATUSEX, self).__init__()
+            self.dwLength = ctypes.sizeof(self)
+
+    kernel32 = ctypes.windll.kernel32
+    stat = MEMORYSTATUSEX()
+    kernel32.GlobalMemoryStatusEx(ctypes.byref(stat))
+
+    ram_bytes = stat.ullTotalPhys
+    ram_mb = ram_bytes // (1024 * 1024)
+    ram_gb = round(ram_mb / 1024, 1)
+    data.append(f"Total RAM: {ram_gb} GB  ({ram_mb} MB)\n")
+
+
+    try:
+        total, used, free = shutil.disk_usage('C:\\')
+        total_gb = round(total / (1024**3), 1)
+        used_gb = round(used / (1024**3), 1)
+        free_gb = round(free / (1024**3), 1)
+        data.append(f"Disk C: Total {total_gb} GB\n")
+        data.append(f"Disk C: Used  {used_gb} GB\n")
+        data.append(f"Disk C: Free  {free_gb} GB\n")
+    except Exception as e:
+        data.append(f"Disk C: Error reading usage - {str(e)}\n")
+    d = [data]
+    data.append("\n=== End of Information ===\n")
+    
+    with open("PcData.txt", "w", encoding="utf-8") as f:
+        f.writelines(data)
+    print("Saved at : PcData.txt")    
+    return d

shadowb-0.1/ShadowB/GetD/my_ip.py

@@ -0,0 +1,12 @@
+import socket
+
+def ip():
+    try:
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(("8.8.8.8", 80))
+        local_ip = s.getsockname()[0]
+        s.close()
+    except:
+        local_ip = "Not available"
+    print(local_ip)
+    return local_ip