Metadata-Version: 2.4
Name: cyberpen
Version: 0.1.1
Summary: CyberPen - pen drive & disk recovery studio with built-in SHIELD antivirus (PySide6 GUI)
Author: StRaNgErDrEaMeR
License-Expression: MIT
Keywords: data-recovery,undelete,file-carving,usb,antivirus,forensics,gui
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Environment :: X11 Applications :: Qt
Classifier: Topic :: System :: Recovery Tools
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PySide6
Requires-Dist: psutil
Provides-Extra: extras
Requires-Dist: pypdf; extra == "extras"
Requires-Dist: yara-python; extra == "extras"
Dynamic: license-file

# CyberPen

Pen drive & disk recovery studio with a modern Qt (PySide6) GUI, light/dark theme, and a built-in SHIELD antivirus.

Developed by **StRaNgErDrEaMeR**.

## Install

```bash
pip install cyberpen
# optional extras (PDF rebuild, YARA rules)
pip install "cyberpen[extras]"
```

## Run

```bash
cyberpen            # or: python -m cyberpen
cyberpen --check    # environment diagnostics
```

Administrator / root is needed for deep raw scans (on Linux use `sudo -E cyberpen`).

## Features

- Drive dashboard (USB / disks, usage, filesystem) and custom device / `.img` path
- Quick scan: Recycle Bin / Trash / lost+found / FOUND.000 fragments
- Deep scan: raw signature carving (JPG, PNG, GIF, MP4, MKV, MP3, FLAC, OGG, PDF, Office/ZIP, DOC, RAR, 7Z, SQLite)
- Bad-sector tolerant disk imaging to `.img`
- FAT16/FAT32/exFAT undelete with original names and folders
- Disk Doctor: MBR/GPT reader, lost-partition finder, surface test
- SHIELD antivirus: heuristics, ClamAV, optional YARA, VirusTotal hash lookup, quarantine vault
- Read-only on the source drive; recovery refuses to write onto the source

## Linux Qt libraries

```bash
sudo apt install libegl1 libgl1 libxkbcommon-x11-0 libxcb-cursor0 libxcb-icccm4 libxcb-keysyms1 libxcb-shape0 libxcb-xinerama0
```
