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} ...

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

optional arguments:
  -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}]
                    (-m SECRET_MESSAGE | -f SECRET_FILE) -o
                    OUTPUT_IMAGE_FILE

optional arguments:
  -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.
  -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}]
                          [-o SECRET_BINARY]

optional arguments:
  -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.
  -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

The command stegano-lsb-set

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

Hide and reveal a text message

# Hide the message with the Sieve of Eratosthenes
$ 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
$ stegano-lsb-set reveal --generator mersenne -i ./surprise.png

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

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

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

An other example:

# Hide the message - LSB with a set defined by the identity function (f(x) = x).
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.
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.
sha1sum ./enc-identity.png ./enc.png

# The output of lsb is given to lsb-set.
stegano-lsb-set reveal -i ./enc.png --generator identity

# The output of lsb-set is given to lsb.
stegano-lsb reveal -i ./enc-identity.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:

stegano-lsb-set reveal -i ./tests/sample-files/Lenna.png --generator fibonacci --shift 7

List all available generators

$ stegano-lsb-set 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.