tracycuiq / stegano

Stéganô is a pure Python steganography module. Different methods of steganography and steganalysis are provided.

Stéganô

Stéganô, a pure Python Steganography module.

Steganography is the art and science of writing hidden messages in such a way that no one, apart from the sender and intended recipient, suspects the existence of the message, a form of security through obscurity. Consequently, functions provided by Stéganô only hide messages, without encryption. Steganography is often used with cryptography.

Installation

$ sudo pip install Stegano

You will be able to use Stéganô in your Python programs or as a command line tool.

Usage

A tutorial is available.

Use Stéganô as a library in your Python program

If you want to use Stéganô in your Python program you just have to import the appropriate steganography technique. For example:

>>> from stegano import lsb
>>> secret = lsb.hide("./tests/sample-files/Lenna.png", "Hello World")
>>> secret.save("./Lenna-secret.png")
>>>
>>> clear_message = lsb.reveal("./Lenna-secret.png")

Use Stéganô as a program

Hide and reveal a message

$ stegano-lsb hide -i ./tests/sample-files/Lenna.png -m "Secret Message" -o Lena1.png
$ stegano-lsb reveal -i Lena1.png
Secret Message

Hide the message with the Sieve of Eratosthenes

$ stegano-lsb-set hide -i ./tests/sample-files/Lenna.png -m 'Secret Message' --generator eratosthenes -o Lena2.png

The message will be scattered in the picture, following a set described by the Sieve of Eratosthenes. Other sets are available. You can also use your own generators.

This will make a steganalysis more complicated.

Running the tests

$ python -m unittest discover -v

Running the static type checker:

$ python tools/run_mypy.py

Contributions

Contributions are welcome. If you want to contribute to Stegano I highly recommend you to install it in a Python virtual environment. For example:

$ git clone https://github.com/cedricbonhomme/Stegano.git
$ cd Stegano/
$ pew install 3.6.3 --type CPython
$ pew new --python=$(pew locate_python 3.6.3)  -a . -r requirements.txt stegano-dev
stegano-dev$ python
Python 3.6.3 (default, Dec  5 2017, 22:12:25) 
[GCC 7.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import stegano
>>>

License

This software is licensed under GNU General Public License version 3

Copyright (C) 2010-2018 Cédric Bonhomme

For more information, the list of authors and contributors is available.