png-parser 0.1.67

A tool to inspect, strip metadata, and hide messages in PNG files.

PNG Parser (WASM & Python)

A high-performance PNG steganography and parsing tool written in Rust. This project provides a unified core that is available for both JavaScript (WebAssembly) and Python.

📦 Available Packages

Platform	Installation	Documentation
JavaScript / WASM	npm install @pranjalpanging/png-parser	JS Guide
Python	pip install png-parser	Python Guide

---

✨ Features

• Blazing Fast: Core logic implemented in Rust for maximum speed.
• Stealthy: Uses custom PNG chunks (stEg) that are ignored by standard image viewers.
• Cross-Platform: Run the same logic in a web browser, Node.js, or a Python script.
• Safe: Includes functions to strip hidden data and restore original file integrity.

---

🚀 JavaScript Usage (Web/Node)

This package is compiled to WebAssembly. When using it in the browser, you must initialize the WASM module first.

import init, { hide_message, read_message } from "@pranjalpanging/png-parser";

async function run() {
    // Initialize the WASM engine
    await init();

    // Example: Reading a message from a Uint8Array (file buffer)
    const secret = read_message(imageBuffer);
    console.log("Hidden message:", secret);
}

run();

Note: For more detailed JS examples, check the pkg/README.md.

🐍 Python Usage

Installation Once the package is uploaded to PyPI, install it via pip:

pip install png-parser

1. Hiding a Message

Embed a secret string into any PNG file. This adds the data safely without corrupting the image.

import png_parser

# Appends a hidden 'stEg' chunk to the image
status = png_parser.hide("my_image.png", "hello world")
print(status) # Output: Success: Message hidden!

2. Reading a Message

Extract the hidden data from the image.

import png_parser

secret = png_parser.read("my_image.png")
print(f"Secret message: {secret}") # Output: Secret message: hello world

3. Deleting the Secret

Remove the hidden chunks and restore the PNG to its original state.

import png_parser

status = png_parser.delete("my_image.png")
print(status) # Output: Success: Secret message deleted!

🛠 Technical Details

This tool manipulates the PNG Chunk Structure. Every PNG consists of a series of chunks. This library inserts an Ancillary Chunk (optional data) named stEg. Standard image viewers skip chunks they don't recognize. By placing our data before the IEND marker, the file remains a valid image while carrying your hidden payload.

🏗 Development

To build this project from source:

• Rust (Cargo)
• Maturin (for Python: pip install maturin)
• wasm-pack (for JS: npm install -g wasm-pack)

Build Python:

maturin develop

Build WASM:

wasm-pack build --target web

Pranjal Panging

License

This project is licensed under the MIT License