Using Stegano in command line

The command stegano-lsb

Hide and reveal a message with the LSB method.

Display help

$ stegano-lsb --help
usage: stegano-lsb [-h] {hide,reveal,list-generators} ...

positional arguments:
{hide,reveal,list-generators}
                        sub-command help
    hide                hide help
    reveal              reveal help
    list-generators     list-generators help

options:
-h, --help            show this help message and exit
$ stegano-lsb hide --help
usage: stegano-lsb hide [-h] -i INPUT_IMAGE_FILE [-e {UTF-8,UTF-32LE}] [-g [GENERATOR_FUNCTION ...]] [-s SHIFT] (-m SECRET_MESSAGE | -f SECRET_FILE) -o OUTPUT_IMAGE_FILE

options:
-h, --help            show this help message and exit
-i INPUT_IMAGE_FILE, --input INPUT_IMAGE_FILE
                        Input image file.
-e {UTF-8,UTF-32LE}, --encoding {UTF-8,UTF-32LE}
                        Specify the encoding of the message to hide. UTF-8 (default) or UTF-32LE.
-g [GENERATOR_FUNCTION ...], --generator [GENERATOR_FUNCTION ...]
                        Generator (with optional arguments)
-s SHIFT, --shift SHIFT
                        Shift for the generator
-m SECRET_MESSAGE     Your secret message to hide (non binary).
-f SECRET_FILE        Your secret to hide (Text or any binary file).
-o OUTPUT_IMAGE_FILE, --output OUTPUT_IMAGE_FILE
                        Output image containing the secret.
$ stegano-lsb reveal --help
usage: stegano-lsb reveal [-h] -i INPUT_IMAGE_FILE [-e {UTF-8,UTF-32LE}] [-g [GENERATOR_FUNCTION ...]] [-s SHIFT] [-o SECRET_BINARY]

options:
-h, --help            show this help message and exit
-i INPUT_IMAGE_FILE, --input INPUT_IMAGE_FILE
                        Input image file.
-e {UTF-8,UTF-32LE}, --encoding {UTF-8,UTF-32LE}
                        Specify the encoding of the message to reveal. UTF-8 (default) or UTF-32LE.
-g [GENERATOR_FUNCTION ...], --generator [GENERATOR_FUNCTION ...]
                        Generator (with optional arguments)
-s SHIFT, --shift SHIFT
                        Shift for the generator
-o SECRET_BINARY      Output for the binary secret (Text or any binary file).

Hide and reveal a text message

$ stegano-lsb hide -i ./tests/sample-files/Lenna.png -m 'Hello World!' -o ./Lenna_enc.png
$ stegano-lsb reveal -i ./Lenna_enc.png
Hello World!

Specify an encoding

$ stegano-lsb hide -i ./tests/sample-files/Lenna.png -m 'I love 🍕 and 🍫.' -e UTF-32LE -o ./Lenna_enc.png
$ stegano-lsb reveal -i ./Lenna_enc.png
I love 🍕 and 🍫.

The default encoding is UTF-8.

Hide and reveal a binary file

$ wget http://www.gnu.org/music/free-software-song.ogg
$ stegano-lsb hide -i ./tests/sample-files/Montenach.png -f ./free-software-song.ogg -o ./Montenach_enc.png
$ rm free-software-song.ogg
$ stegano-lsb reveal -i ./Montenach_enc.png -o ./song.ogg

Sets are used in order to select the pixels where the message will be hidden.

Hide and reveal a text message with set

# Hide the message with the Sieve of Eratosthenes
$ stegano-lsb hide -i ./tests/sample-files/Montenach.png --generator eratosthenes -m 'Joyeux Noël!' -o ./surprise.png

# Try to reveal with Mersenne numbers
$ stegano-lsb reveal --generator mersenne -i ./surprise.png

# Try to reveal with fermat numbers
$ stegano-lsb reveal --generator fermat -i ./surprise.png

# Try to reveal with carmichael numbers
$ stegano-lsb reveal --generator carmichael -i ./surprise.png

# Try to reveal with Sieve of Eratosthenes
$ stegano-lsb reveal --generator eratosthenes -i ./surprise.png

Sometimes it can be useful to skip the first values of a set. For example if you want to hide several messages or because due to the selected generator (Fibonacci starts with 0, 1, 1, etc.). Or maybe you just want to add more complexity. In this case, simply use the optional arguments --shift or -s:

$ stegano-lsb hide -i ./tests/sample-files/Lenna.png -m 'Shifted secret message' -o ~/Lenna1.png --shift 7
$ stegano-lsb reveal -i ~/Lenna1.png --shift 7
Shifted secret message

List all available generators

$ stegano-lsb list-generators
Generator id:
    ackermann
Desciption:
    Ackermann number.

Generator id:
    ackermann_naive
Desciption:
    Ackermann number.

Generator id:
    carmichael
Desciption:
    Composite numbers n such that a^(n-1) == 1 (mod n) for every a coprime
    to n.
    https://oeis.org/A002997

Generator id:
    composite
Desciption:
    Generate the composite numbers using the sieve of Eratosthenes.
    https://oeis.org/A002808

Generator id:
    eratosthenes
Desciption:
    Generate the prime numbers with the sieve of Eratosthenes.
    https://oeis.org/A000040

Generator id:
    fermat
Desciption:
    Generate the n-th Fermat Number.
    https://oeis.org/A000215

Generator id:
    fibonacci
Desciption:
    Generate the sequence of Fibonacci.
    https://oeis.org/A000045

Generator id:
    identity
Desciption:
    f(x) = x

Generator id:
    log_gen
Desciption:
    Logarithmic generator.

Generator id:
    mersenne
Desciption:
    Generate 2^p - 1, where p is prime.
    https://oeis.org/A001348

Generator id:
    triangular_numbers
Desciption:
    Triangular numbers: a(n) = C(n+1,2) = n(n+1)/2 = 0+1+2+...+n.
    http://oeis.org/A000217

The command stegano-red

Hide and reveal a text message with the red portion of a pixel.

Display help

$ stegano-red hide --help
usage: stegano-red hide [-h] [-i INPUT_IMAGE_FILE] [-m SECRET_MESSAGE]
                    [-o OUTPUT_IMAGE_FILE]

optional arguments:
-h, --help            show this help message and exit
-i INPUT_IMAGE_FILE, --input INPUT_IMAGE_FILE
                    Image file
-m SECRET_MESSAGE     Your secret message to hide (non binary).
-o OUTPUT_IMAGE_FILE, --output OUTPUT_IMAGE_FILE
                    Image file

Hide and reveal a text message

$ stegano-red hide -i ./tests/sample-files/Lenna.png -m 'Basic steganography technique.' -o ~/Lenna1.png
$ stegano-red reveal -i ~/Lenna1.png
Basic steganography technique.