Updated documentation and README.

This commit is contained in:
Cédric Bonhomme 2015-12-23 13:21:46 +01:00
parent fd44b9aca9
commit 8ea19492c9
No known key found for this signature in database
GPG key ID: A1CB94DE57B7A70D
3 changed files with 23 additions and 43 deletions

View file

@ -41,7 +41,7 @@ Examples
There are some examples in the folder *examples*. There are some examples in the folder *examples*.
$ hg clone https://bitbucket.org/cedricbonhomme/stegano $ git clone https://github.com/cedricbonhomme/Stegano.git
$ cd stegano/examples $ cd stegano/examples

View file

@ -9,32 +9,19 @@ Welcome to Stéganô's documentation!
.. toctree:: .. toctree::
:maxdepth: 2 :maxdepth: 2
Stéganô is a Python steganography_ module. Stéganô_ is a Python steganography_ module.
Steganography is the art and science of writing hidden messages in such a way that no one, 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 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 message, of security through obscurity. Consequently, functions provided by Stéganô only hide message,
without encryption. Indeed steganography is often used with cryptography. without encryption. Indeed steganography is often used with cryptography.
The advantage of steganography, over cryptography alone, is that messages do not attract
attention to themselves. If you are interested in cryptography have a look at my project pySecret.
Download Stéganô
================
You can clone the source code of Stéganô_ :
.. code-block:: bash
$ hg clone https://bitbucket.org/cedricbonhomme/stegano/
More information about how to install Stéganô in the :doc:`tutorial </tutorial>`.
Requirements Requirements
============ ============
- Python_ >= 3.2 (tested with Python 3.3.1); - Python_ >= 3.2 (tested with Python 3.3.1);
- `Pillow`_ (friendly fork of Python Imaging Library). - `Pillow`_.
Methods of hiding Methods of hiding
================= =================
@ -57,30 +44,27 @@ Turorial
More information available at the :doc:`tutorial </tutorial>` page More information available at the :doc:`tutorial </tutorial>` page
License License
======= =======
Stéganô is under GPL v3 license. Stéganô_ is under GPL v3 license.
Donation Donation
======== ========
If you wish and if you like Stéganô, you can donate via bitcoin. My bitcoin address: `1GVmhR9fbBeEh7rP1qNq76jWArDdDQ3otZ <http://blockexplorer.com/address/1GVmhR9fbBeEh7rP1qNq76jWArDdDQ3otZ>`_ If you wish and if you like Stéganô, you can donate via bitcoin. My bitcoin address: `1GVmhR9fbBeEh7rP1qNq76jWArDdDQ3otZ <http://blockexplorer.com/address/1GVmhR9fbBeEh7rP1qNq76jWArDdDQ3otZ>`_
Contact Contact
======= =======
`My home page <http://cedricbonhomme.org>`_ `My home page <https://www.cedricbonhomme.org>`_
Indices and tables
==================
* :ref:`genindex` .. _Python: http://python.org
* :ref:`modindex` .. _Stéganô: https://github.com/cedricbonhomme/Stegano
* :ref:`search`
.. _Python: http://python.org/
.. _Stéganô: https://bitbucket.org/cedricbonhomme/stegano/
.. _`Pillow`: https://pypi.python.org/pypi/Pillow .. _`Pillow`: https://pypi.python.org/pypi/Pillow
.. _steganography: http://en.wikipedia.org/wiki/Steganography .. _steganography: http://en.wikipedia.org/wiki/Steganography
.. _steganalysis: http://en.wikipedia.org/wiki/Steganalysis .. _steganalysis: http://en.wikipedia.org/wiki/Steganalysis

View file

@ -1,18 +1,16 @@
Getting Stéganô Getting the source code of Stéganô
=============== ==================================
.. code-block:: bash .. code-block:: bash
$ hg clone https://bitbucket.org/cedricbonhomme/stegano $ git clone https://github.com/cedricbonhomme/Stegano.git
$ cd stegano/
$ chmod u+x *.py # if you want to use Stéganô in command line
Installation Installation
============ ============
.. code-block:: bash .. code-block:: bash
$ python setup.py install $ sudo pip install Stegano
Now you will be able to use Stéganô in your Python program. Now you will be able to use Stéganô in your Python program.
@ -38,8 +36,8 @@ Display help
.. code-block:: bash .. code-block:: bash
$ ./slsb.py --help $ slsb --help
Usage: slsb.py [options] Usage: slsb [options]
Options: Options:
--version show program's version number and exit --version show program's version number and exit
@ -63,8 +61,8 @@ Hide and reveal a text message
.. code-block:: bash .. code-block:: bash
$ ./slsb.py --hide -i ./pictures/Lenna.png -o ./pictures/Lenna_enc.png -m HelloWorld! $ slsb --hide -i ./pictures/Lenna.png -o ./pictures/Lenna_enc.png -m HelloWorld!
$ ./slsb.py --reveal -i ./pictures/Lenna_enc.png $ slsb --reveal -i ./pictures/Lenna_enc.png
HelloWorld! HelloWorld!
Hide and reveal a binary file Hide and reveal a binary file
@ -73,9 +71,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
$ ./slsb.py --hide -i ./pictures/Montenach.png -o ./pictures/Montenach_enc.png -f ./free-software-song.ogg $ slsb --hide -i ./pictures/Montenach.png -o ./pictures/Montenach_enc.png -f ./free-software-song.ogg
$ rm free-software-song.ogg $ rm free-software-song.ogg
$ ./slsb.py --reveal -i ./pictures/Montenach_enc.png -b ./song.ogg $ slsb --reveal -i ./pictures/Montenach_enc.png -b ./song.ogg
Hide and reveal a message by using the description field of the image Hide and reveal a message by using the description field of the image
--------------------------------------------------------------------- ---------------------------------------------------------------------
@ -90,6 +88,4 @@ Steganalysis
.. code-block:: bash .. code-block:: bash
$ ./steganalysis-parity.py -i ./pictures./Lenna_enc.png -o ./pictures/Lenna_enc_st.png $ steganalysis-parity -i ./pictures./Lenna_enc.png -o ./pictures/Lenna_enc_st.png