ste

steganography

A tool to conceal files into images

Showing:

Popularity

Downloads/wk

3

GitHub Stars

22

Maintenance

Last Commit

1yr ago

Contributors

2

Package

Dependencies

2

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Overview Build Status

Conceals any type of file into images.

It uses a LSB algorithm. The idea comes from http://domnit.org/blog/2007/02/stepic-explanation.html

Check a blog post with an example: https://rodrigouroz.github.io/2016/06/13/hiding-things-at-plain-sight/

Instalation

Python is required.

This is aimed to be installed globally as a command line tool

npm install -g steganography

Or, clone this repository and run npm install

This module depends on lwip, check setup instructions for your system if the installation fails

Quickstart

It has two different actions

Embed

Embeds a file into a host image. Outputs the host file with the concealed file embedded as a new file

steganography embed <host_file> <guest_file> [<output_file>] [<password>]

By default output_file is 'output.png' in the same folder

If password is used the data is encrypted with AES256. You'll need the password to retrieve the embedded file

Example

steganography embed host.jpg secret.pdf output secret-password

This will create the file output.png in the current folder. You can share this file with anyone.

They will need the password to recover the embedded file.

Dig up

Retrieves a concealed file from an image.

steganography dig-up <image_file> [<output_folder>] [<password>]

By default output_folder is the current folder.

Example

steganography dig-up output.png ./ secret-password

Contributions

Contributions are welcome. Fork this repository and issue a PR with your changes.

Please add new tests for new functionality, adapt the existing ones if needed, and make sure that npm test succeeds.

TODO

  • Input file check
    • Must be in RGB format
    • It can be determined before starting whether the file fits or not
    • Better command line support (named options such as --output=folder --password=pass)

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100