Metadata-Version: 2.1
Name: ShadowB
Version: 0.4
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
Requires-Dist: requests
Requires-Dist: colorama
Requires-Dist: better-profanity
Requires-Dist: pillow
Requires-Dist: pypdf
Requires-Dist: qrcode
Requires-Dist: stepic
Requires-Dist: browser-cookie3

# ShadowB

![ShadowB Logo](https://raw.githubusercontent.com/erec2smith/ShadowB/main/shadowb.jpg)


**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 for : 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

```

---

## `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
