Metadata-Version: 2.4
Name: ghostbit
Version: 0.1.0
Summary: A Python library for image steganography using LSB encoding
Home-page: https://github.com/yourusername/ghostbit-py
Author: Ghostbit
Author-email: 
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: Pillow>=10.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: scipy>=1.10.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Dynamic: home-page
Dynamic: requires-python

# Ghostbit

A Python library for image steganography using LSB (Least Significant Bit) encoding.

## Features

- **LSB Steganography**: Encode and decode secret messages in images using the Least Significant Bit method
- **DCT Steganography**: Alternative encoding method using Discrete Cosine Transform
- **Image Analysis**: Detect hidden data and calculate image quality metrics

## Installation

```bash
pip install ghostbit
```

Or install from source:

```bash
cd ghostbit-py
pip install -e .
```

## Quick Start

```python
from ghostbit import encode_lsb, decode_lsb

# Encode a message into an image
encode_lsb("cover_image.png", "secret message", "stego_image.png")

# Decode a message from an image
message = decode_lsb("stego_image.png")
print(message)  # Output: secret message
```

## Usage Examples

### Basic Encoding/Decoding

```python
from ghostbit import encode_lsb, decode_lsb

# Encode a secret message
encode_lsb("input.png", "My secret password", "output.png")

# Decode the message
secret = decode_lsb("output.png")
```


## API Reference

### Steganography Functions

- `encode_lsb(img_path, message, output_path)` - Encode message using LSB
- `decode_lsb(img_path)` - Decode message using LSB
- `encode_dct(img_path, message, output_path, block_size=8)` - Encode using DCT
- `decode_dct(img_path, block_size=8)` - Decode using DCT
- `detect_hidden_data(img_path, method='decode')` - Detect hidden data
- `calculate_psnr(img1_path, img2_path)` - Calculate PSNR between images

## Requirements

- Python >= 3.8
- Pillow >= 10.0.0
- numpy >= 1.24.0
- scipy >= 1.10.0

## License

MIT License

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.
