Metadata-Version: 2.4
Name: RattleScan
Version: 1.1.0
Summary: Forensic metadata analysis and secure file cleaning tool for CLI environments.
Home-page: https://github.com/dsient/rattlescan
Author: DSiENT
Author-email: w.caskey7@gmail.com
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Security
Classifier: Topic :: System :: Filesystems
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: python-magic>=0.4.27
Requires-Dist: Pillow>=9.0.0
Requires-Dist: PyPDF2>=3.0.0
Requires-Dist: mutagen>=1.45.0
Provides-Extra: ui
Requires-Dist: pytermgui>=7.0.0; extra == "ui"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# RATTLESCAN

**Forensic metadata analysis and secure file cleaning tool for the command line.**

A fast CLI tool to inspect, analyze, and clean file metadata. Works on Windows, macOS, and Linux.

## Installation

```bash
pip install rattlescan

## With optional TUI (interactive menu): ##
pip install rattlescan[ui]
```

## Usage

```bash
## Analyze a file ##
rattlescan photo.jpg

## Analyze and prompt for cleaning ##
rattlescan document.pdf --clean

## Analyze with custom output path ##
rattlescan image.png --clean --output cleaned_image.png

## Secure wipe (destructive!) ##
rattlescan sensitive.pdf --wipe -y

## Scan only, no interactive menu ##
rattlescan file.txt --no-interactive

## Check version ##
rattlescan --version
```

## Features

- **Cryptographic hashes**: MD5, SHA-1, SHA-256
- **File type detection**: MIME type identification and extension validation
- **Entropy analysis**: Detect encrypted or compressed content
- **EXIF extraction**: GPS, camera info, timestamps from images
- **PDF metadata**: Author, title, creation date, page count
- **Audio/video tags**: ID3, duration, bitrate, sample rate
- **Metadata cleaning**: Strip EXIF, PDF info, audio tags
- **Secure wipe**: DOD 5220.22-M 3-pass overwrite

## Dependencies

- `python-magic` - File type detection
- `Pillow` - Image/EXIF handling
- `PyPDF2` - PDF metadata
- `mutagen` - Audio/video metadata
- `pytermgui` *(optional)* - Enhanced interactive UI

## License

MIT
