fz0x1/Stegano
1
0
Fork 0
mirror of https://github.com/cedricbonhomme/Stegano.git synced 2025-05-12 09:08:31 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Updated documentation.

Browse source
This commit is contained in:
Cédric Bonhomme 2017-05-06 00:00:50 +02:00
parent 9b2dae3a99
commit f5c22be82b
No known key found for this signature in database
GPG key ID: A1CB94DE57B7A70D
2 changed files with 24 additions and 29 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

45
docs/software.rst
View file

@ -6,8 +6,8 @@ Display help
.. code-block:: bash .. code-block:: bash
$ lsb --help $ stegano-lsb --help
usage: lsb [-h] {hide,reveal} ... usage: stegano-lsb [-h] {hide,reveal} ...
positional arguments: positional arguments:
{hide,reveal} sub-command help {hide,reveal} sub-command help
@ -20,8 +20,8 @@ Display help
.. code-block:: bash .. code-block:: bash
$ lsb hide --help $ stegano-lsb hide --help
usage: lsb hide [-h] -i INPUT_IMAGE_FILE (-m SECRET_MESSAGE | -f SECRET_FILE) usage: stegano-lsb hide [-h] -i INPUT_IMAGE_FILE (-m SECRET_MESSAGE | -f SECRET_FILE)
-o OUTPUT_IMAGE_FILE -o OUTPUT_IMAGE_FILE
optional arguments: optional arguments:
@ -36,8 +36,8 @@ Display help
.. code-block:: bash .. code-block:: bash
$ lsb reveal --help $ stegano-lsb reveal --help
usage: lsb reveal [-h] -i INPUT_IMAGE_FILE [-o SECRET_BINARY] usage: stegano-lsb reveal [-h] -i INPUT_IMAGE_FILE [-o SECRET_BINARY]
optional arguments: optional arguments:
-h, --help show this help message and exit -h, --help show this help message and exit
@ -52,8 +52,8 @@ Hide and reveal a text message with the LSB method
.. code-block:: bash .. code-block:: bash
$ lsb hide -i ./tests/sample-files/Lenna.png -m 'Hello World!' -o ./Lenna_enc.png $ stegano-lsb hide -i ./tests/sample-files/Lenna.png -m 'Hello World!' -o ./Lenna_enc.png
$ lsb reveal -i ./Lenna_enc.png $ stegano-lsb reveal -i ./Lenna_enc.png
Hello World! Hello World!
Hide and reveal a binary file Hide and reveal a binary file
@ -62,9 +62,9 @@ Hide and reveal a binary file
.. code-block:: bash .. code-block:: bash
$ wget http://www.gnu.org/music/free-software-song.ogg $ wget http://www.gnu.org/music/free-software-song.ogg
$ lsb hide -i ./tests/sample-files/Montenach.png -f ./free-software-song.ogg -o ./Montenach_enc.png $ stegano-lsb hide -i ./tests/sample-files/Montenach.png -f ./free-software-song.ogg -o ./Montenach_enc.png
$ rm free-software-song.ogg $ rm free-software-song.ogg
$ lsb reveal -i ./Montenach_enc.png -o ./song.ogg $ stegano-lsb reveal -i ./Montenach_enc.png -o ./song.ogg
Hide and reveal a text message with the LSB method and generated sets Hide and reveal a text message with the LSB method and generated sets
--------------------------------------------------------------------- ---------------------------------------------------------------------
@ -74,22 +74,22 @@ Sets are used in order to select the pixels where the message will be hidden.
.. code-block:: bash .. code-block:: bash
# Hide the message with the Sieve of Eratosthenes # Hide the message with the Sieve of Eratosthenes
$ lsb-set hide -i ./tests/sample-files/Montenach.png --generator eratosthenes -m 'Joyeux Noël!' -o ./surprise.png $ stegano-lsb-set hide -i ./tests/sample-files/Montenach.png --generator eratosthenes -m 'Joyeux Noël!' -o ./surprise.png
# Try to reveal with Mersenne numbers # Try to reveal with Mersenne numbers
$ lsb-set reveal --generator mersenne -i ./surprise.png $ stegano-lsb-set reveal --generator mersenne -i ./surprise.png
# Try to reveal with fermat numbers # Try to reveal with fermat numbers
$ lsb-set reveal --generator fermat -i ./surprise.png $ stegano-lsb-set reveal --generator fermat -i ./surprise.png
# Try to reveal with carmichael numbers # Try to reveal with carmichael numbers
$ lsb-set reveal --generator carmichael -i ./surprise.png $ stegano-lsb-set reveal --generator carmichael -i ./surprise.png
# Try to reveal with Sieve of Eratosthenes # Try to reveal with Sieve of Eratosthenes
$ lsb-set reveal --generator eratosthenes -i ./surprise.png $ stegano-lsb-set reveal --generator eratosthenes -i ./surprise.png
# List all available generators # List all available generators
$ lsb-set list-generators $ stegano-lsb-set list-generators
Generator id: Generator id:
ackermann ackermann
Desciption: Desciption:
@ -141,11 +141,6 @@ Sets are used in order to select the pixels where the message will be hidden.
Generate 2^n - 1. Generate 2^n - 1.
https://oeis.org/A001348 https://oeis.org/A001348
Generator id:
syracuse
Desciption:
Generate the sequence of Syracuse.
Generator id: Generator id:
triangular_numbers triangular_numbers
Desciption: Desciption:
@ -158,19 +153,19 @@ An other example:
.. code-block:: bash .. code-block:: bash
# Hide the message - LSB with a set defined by the identity function (f(x) = x). # Hide the message - LSB with a set defined by the identity function (f(x) = x).
lsb-set hide -i ./tests/sample-files/Montenach.png --generator identity -m 'I like steganography.' -o ./enc-identity.png stegano-lsb-set hide -i ./tests/sample-files/Montenach.png --generator identity -m 'I like steganography.' -o ./enc-identity.png
# Hide the message - LSB only. # Hide the message - LSB only.
lsb hide -i ./tests/sample-files/Montenach.png -m 'I like steganography.' -o ./enc.png stegano-lsb hide -i ./tests/sample-files/Montenach.png -m 'I like steganography.' -o ./enc.png
# Check if the two generated files are the same. # Check if the two generated files are the same.
sha1sum ./enc-identity.png ./enc.png sha1sum ./enc-identity.png ./enc.png
# The output of lsb is given to lsb-set. # The output of lsb is given to lsb-set.
lsb-set reveal -i ./enc.png --generator identity stegano-lsb-set reveal -i ./enc.png --generator identity
# The output of lsb-set is given to lsb. # The output of lsb-set is given to lsb.
lsb reveal -i ./enc-identity.png stegano-lsb reveal -i ./enc-identity.png
Hide and reveal a text message with the red portion of a pixel Hide and reveal a text message with the red portion of a pixel

8
docs/steganalysis.rst
View file

@ -7,13 +7,13 @@ Parity
.. code-block:: bash .. code-block:: bash
# Hide the message with Sieve of Eratosthenes # Hide the message with Sieve of Eratosthenes
lsb-set hide -i ./tests/sample-files/20160505T130442.jpg -o ./surprise.png --generator eratosthenes -m 'Very important message.' stegano-lsb-set hide -i ./tests/sample-files/20160505T130442.jpg -o ./surprise.png --generator eratosthenes -m 'Very important message.'
# Steganalysis of the original photo # Steganalysis of the original photo
steganalysis-parity -i ./tests/sample-files/20160505T130442.jpg -o ./surprise_st_original.png stegano-steganalysis-parity -i ./tests/sample-files/20160505T130442.jpg -o ./surprise_st_original.png
# Steganalysis of the secret photo # Steganalysis of the secret photo
steganalysis-parity -i ./surprise.png -o ./surprise_st_secret.png stegano-steganalysis-parity -i ./surprise.png -o ./surprise_st_secret.png
# Reveal with Sieve of Eratosthenes # Reveal with Sieve of Eratosthenes
lsb-set reveal -i ./surprise.png --generator eratosthenes stegano-lsb-set reveal -i ./surprise.png --generator eratosthenes