#image

pyxelium

Pyxelium is a lightweight pixel-based encryption library that allows you to encode and decode messages within PNG images. It provides Rust functions for encoding and decoding messages using pixel-based encryption.

6 releases

0.0.6 Feb 5, 2024
0.0.5 Feb 4, 2024

#689 in Images

MIT license

13KB
128 lines

Pyxelium Rust

Screenshot Screenshot

[!WARNING]
For now newer versions are possible to be incompatible with older versions, due to changes in the encoding algorithm!

Pyxelium is a lightweight pixel-based encryption library that allows you to encode and decode messages within PNG images.

Why? I have no idea, but if you find any good reason to use this project, let me know!

Features

  • Encode text messages into images.
  • Decode hidden messages from images.

Usage

Encoding a Message

To encode a message into an image using Pyxelium, use the following Rust function:

use image::{Rgba, RgbaImage};
use pyxelium::string_to_pixels;

fn main() {
    let message = "Your message goes here";
    let pixel_size = 5;
    let base_color = Rgba([128, 128, 128, 255]);
    
    let encoded_image: RgbaImage = string_to_pixels(message, pixel_size, base_color);
    
    // Save the image into a file
    encoded_image.save("encoded_image.png").unwrap();
}

This function will encode your message into an RgbaImage object.

Decoding a Message

To decode a message from an image using Pyxelium, use the following Rust function:

use image::{io::Reader as ImageReader, Rgba};
use pyxelium::decode_pixels_to_string;

fn main() {
    let image_path = "encoded_image.png";
    let pixel_size = 5;
    let base_color = Rgba([128, 128, 128, 255]);
    
    let encoded_image = ImageReader::open(image_path).unwrap().decode().unwrap().to_rgba8();
    
    let decoded_message_result = decode_pixels_to_string(&encoded_image, pixel_size, base_color);
    
    match decoded_message_result {
        Ok(decoded_message) => {
            println!("Decoded Message: {}", decoded_message);
        }
        Err(err) => {
            eprintln!("Error decoding message: {}", err);
        }
    }
}

Replace "image.png" with the path to the image you want to decode. The decoded message will be available as a Result<String, std::string::FromUtf8Error>.

Getting Started

  1. Add Pyxelium as a dependency to your Cargo.toml:
[dependencies]
pyxelium = "0.0.6"
  1. Import the necessary modules and use the functions as shown in the usage examples above.

Contributing

Contributions to Pyxelium are welcome! Feel free to open issues or submit pull requests.

License

This project is open-source and available under the MIT License. You are free to use, modify, and distribute this software.

Dependencies

~5MB
~66K SLoC