chg: [security] fix CVE-2023-32681 (GHSA-j8r2-6x86-q33q).
chg: [dependencies] Updated Python dependencies.
Stegano, 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 Stegano only hide messages, without encryption. Steganography is often used with cryptography.
For reporting issues, visit the tracker here: https://todo.sr.ht/~cedric/stegano
$ poetry install stegano
You will be able to use Stegano in your Python programs.
If you only want to install Stegano as a command line tool:
$ pipx install stegano
pipx installs scripts (system wide available) provided by Python packages into separate virtualenvs to shield them from your system and each other.
A tutorial is available.
If you want to use Stegano 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")
$ stegano-lsb hide -i ./tests/sample-files/Lenna.png -m "Secret Message" -o Lena1.png $ stegano-lsb reveal -i Lena1.png Secret Message
$ stegano-lsb 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.
$ python -m unittest discover -v
Running the static type checker:
$ mypy stegano
Contributions are welcome. If you want to contribute to Stegano I highly recommend you to install it in a Python virtual environment with poetry.
This software is licensed under GNU General Public License version 3
Copyright (C) 2010-2023 Cédric Bonhomme
For more information, the list of authors and contributors is available.