Crate steganographyrs

source ·
Expand description

Steganography

Steganography is a Rust library that inject a message into an image.

The word steganography means to hide something. There is a variety of ways to accomplish steganography. This library relies on the least significant bits.

How to Use the Library?

Inject a Text into an Image

You can use it without a password. In that case the injection of the message inside the color of the image is less secure but take less space and faster to generate.

use steganographyrs::steganography;
use steganographyrs::options::{SteganographyOption, SteganographyInjectOption};

let options = SteganographyInjectOption {
            message: "Test Message".to_string(),
            password: None,
            input_image_path: "testAssets/prestine.png".to_string(),
            output_image_path: "testAssets/image_with_secret_message.png".to_string(),
        };
let result = steganography(SteganographyOption::InjectMessageIntoImage(options));
assert_eq!(None, result)

You can add a password as a string to modify the message before insertion into the image.

use steganographyrs::steganography;
use steganographyrs::options::{SteganographyOption, SteganographyInjectOption};

let options = SteganographyInjectOption {
    message: "Test Message".to_string(),
    password: Some("Secret Password Here".to_string()),
    input_image_path: "testAssets/prestine.png".to_string(),
    output_image_path: "testAssets/image_with_secret_message.png".to_string(),
};
let result = steganography(SteganographyOption::InjectMessageIntoImage(options));
assert_eq!(None, result)

Extract Text into Image

The opposite operation is to get the hidden message from the image. Similar to inject the message, the extraction can be with or without a password.

use steganographyrs::steganography;
use steganographyrs::options::{SteganographyOption, SteganographyExtractOption};

let options = SteganographyExtractOption {
    input_image_path: "testAssets/out_message_Bye_2.png".to_string(),
    password: None,
};
let recovered_message = steganography(SteganographyOption::ExtractMessageFromImage(options)).unwrap();
assert_eq!("Test Message", recovered_message);

If the message was encrypted, the same password is required to retrieve the message:

use steganographyrs::steganography;
use steganographyrs::options::{SteganographyOption, SteganographyExtractOption};

let options = SteganographyExtractOption {
    input_image_path: "testAssets/out_message_Bye_3.png".to_string(),
    password: Some("Secret Password Here".to_string()),
};
let recovered_message = steganography(SteganographyOption::ExtractMessageFromImage(options)).unwrap();
assert_eq!("Test Message", recovered_message);

How to Use the CLI?

The crate contains a terminal implementation that take parameters to inject or extract the secret string.

Hide a String without Encryption in an Image

steganographyrs -e inject -m "My Secret Message" -i testAssets/prestine.png -o out.png

Hide an Encrypted String in an Image

steganographyrs -e inject -p secret -m "My Secret Message" -i testAssets/prestine.png -o out.png

Additional Resource

Modules

options

Functions

steganography