https://github.com/dridk/ninam

hide a secret message in a text using different white space characters.
https://github.com/dridk/ninam

python secret steganography

Last synced: 6 months ago
JSON representation

hide a secret message in a text using different white space characters.

• Host: GitHub
• URL: https://github.com/dridk/ninam
• Owner: dridk
• License: mit
• Created: 2024-05-29T11:41:26.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-06-02T13:14:03.000Z (about 2 years ago)
• Last Synced: 2025-10-14T12:32:55.575Z (9 months ago)
• Topics: python, secret, steganography
• Language: Python
• Homepage: https://dridk.github.io/ninam/
• Size: 25.4 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Ninam

![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ninam)

![PyPI - Downloads](https://img.shields.io/pypi/dm/ninam)

Ninam is a steganography tool for encoding and decoding a payload in a text by replacing white space characters.

I created this programme because I remembered when I was younger that I liked to send people secret messages by hiding them in a text message or an email.

[See the demo](https://dridk.github.io/ninam/)

## How it works ? 

All spaces in the text are recovered and replaced by other [unicode space characters](https://en.wikipedia.org/wiki/Whitespace_character). If there is not enough space available, additional spaces will be added at the end. 

You can use 1-bit, 2-bit or 4-bit encoding. This means using 2, 4 or 16 white spaces. The larger the bitsize, the larger your payload can be, but at the risk of having slightly suspicious white spaces which doesn't work everywhere.

## Installation 

There is no dependencies. It should work with all version of python>3.x

```bash

pip install ninam

```

## Usage 

``` bash  

    # By default it uses 2 bits

    ninam encode -i input.txt -p iloveyou > output.txt

    ninam decode -i output.txt 

    # Alternative bitsize

    ninam encode -b 4 -i input.txt -p iloveyou > output.txt

    ninam decode -b 4 -i output.txt  

    

```

## From git 

```

git clone git@github.com:dridk/ninam.git

python -m ninam 

```