8 releases (3 stable)

Uses old Rust 2015

1.0.2 May 2, 2019
1.0.1 Aug 28, 2018
1.0.0 Sep 18, 2017
0.2.3 Sep 6, 2017
0.1.0 Apr 18, 2017

#222 in Encoding

38 downloads per month
Used in stegan

MIT license

145 lines

Build Status Build Status Build status Crates.io Crates.io Docs.rs dependency status


A stable steganography library written in rust



Add the following to the Cargo.toml in your project:

steganography = "*"

and import using extern crate:

extern crate steganography;

use steganography::encoder::*;
use steganography::decoder::*;
use steganography::util::*;

Writing a message to a file

//Define a secret message to hide in out picture
let message = "This is a steganography demo!".to_string();
//Convert our string to bytes
let payload = str_to_bytes(&message);
//Load the image where we want to embed our secret message
let destination_image = file_as_dynamic_image("example.jpg".to_string());
//Create an encoder
let enc = Encoder::new(payload, destination_image);
//Encode our message into the alpha channel of the image
let result = enc.encode_alpha();
//Save the new image
save_image_buffer(result, "hidden_message.png".to_string());

Reading a message from a file

//Load the image with the secret message
let encoded_image = file_as_image_buffer("examples/decode_message.png".to_string());
//Create a decoder
let dec = Decoder::new(encoded_image);
//Decode the image by reading the alpha channel
let out_buffer = dec.decode_alpha();
//If there is no alpha, it's set to 255 by default so we filter those out
let clean_buffer: Vec<u8> = out_buffer.into_iter()
                                    .filter(|b| {
                                        *b != 0xff_u8
//Convert those bytes into a string we can read
let message = bytes_to_str(clean_buffer.as_slice());
//Print it out!
println!("{:?}", message);

Running the examples

cargo build --example example_encode
cargo run --example example_encode
cargo build --example example_decode
cargo run --example example_decode


cargo test -- --test-threads=1


~73K SLoC