Metadata-Version: 2.4
Name: emojito-py
Version: 0.1.0
Summary: Encode text into emojis using Unicode steganography
Project-URL: Homepage, https://github.com/matijaoe/emojito
Project-URL: Bug Tracker, https://github.com/matijaoe/emojito/issues
Project-URL: Repository, https://github.com/matijaoe/emojito.git
Author-email: Matija Osrečki <python@matijao.com>
License-Expression: MIT
License-File: LICENSE
Keywords: emoji,encoding,steganography,unicode
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# 🍹 emojito

*emojis with a hidden agenda.*

emojito is a Python library and CLI tool that lets you secretly encode text into emojis, hiding messages in plain sight. It works by using Unicode steganography to invisibly embed information into ordinary emoji characters, enabling you to discreetly share hidden messages in chats, posts, or anywhere emojis are supported.

Inspired by Paul Butler's article ["Smuggling Arbitrary Data Through an Emoji"](https://paulbutler.org/2025/smuggling-arbitrary-data-through-an-emoji/).

## Installation

Install from PyPI:
```bash
pip install emojito
```

Or install the latest development version directly from GitHub:
```bash
pip install git+https://github.com/matijaoe/emojito.git
```

## Usage

### CLI

#### Encode

```bash
emojito encode '🍹' 'trust no one'
# 🍹󠅤󠅢󠅥󠅣󠅤󠄐󠅞󠅟󠄐󠅟󠅞󠅕️
```

#### Decode

```bash
emojito decode '🍹󠅤󠅢󠅥󠅣󠅤󠄐󠅞󠅟󠄐󠅟󠅞󠅕️' 
# trust no one
```

### Python

#### Encode

```py
from emojito import encode, decode

secret = encode('🍹', 'trust no one')
print(secret) # **🍹󠅤󠅢󠅥󠅣󠅤󠄐󠅞󠅟󠄐󠅟󠅞󠅕️**

decoded = decode(secret)
print(decoded) # trust no one
```
