emojito-py


Nameemojito-py JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
SummaryEncode text into emojis using Unicode steganography
upload_time2025-03-06 22:40:01
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseNone
keywords emoji encoding steganography unicode
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 🍹 emojito

[![PyPI version](https://badge.fury.io/py/emojito-py.svg)](https://pypi.org/project/emojito-py/)

*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-py
```

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
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "emojito-py",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "emoji, encoding, steganography, unicode",
    "author": null,
    "author_email": "Matija Osre\u010dki <python@matijao.com>",
    "download_url": "https://files.pythonhosted.org/packages/32/0b/1b4623a1a65ca82ee314cdffa8e1db9c5ccc666815abe6d78c163eac9c34/emojito_py-0.1.1.tar.gz",
    "platform": null,
    "description": "# \ud83c\udf79 emojito\n\n[![PyPI version](https://badge.fury.io/py/emojito-py.svg)](https://pypi.org/project/emojito-py/)\n\n*emojis with a hidden agenda.*\n\nemojito 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.\n\nInspired by Paul Butler's article [\"Smuggling Arbitrary Data Through an Emoji\"](https://paulbutler.org/2025/smuggling-arbitrary-data-through-an-emoji/).\n\n## Installation\n\nInstall from PyPI:\n```bash\npip install emojito-py\n```\n\nOr install the latest development version directly from GitHub:\n```bash\npip install git+https://github.com/matijaoe/emojito.git\n```\n\n## Usage\n\n### CLI\n\n#### Encode\n\n```bash\nemojito encode '\ud83c\udf79' 'trust no one'\n# \ud83c\udf79\udb40\udd64\udb40\udd62\udb40\udd65\udb40\udd63\udb40\udd64\udb40\udd10\udb40\udd5e\udb40\udd5f\udb40\udd10\udb40\udd5f\udb40\udd5e\udb40\udd55\ufe0f\n```\n\n#### Decode\n\n```bash\nemojito decode '\ud83c\udf79\udb40\udd64\udb40\udd62\udb40\udd65\udb40\udd63\udb40\udd64\udb40\udd10\udb40\udd5e\udb40\udd5f\udb40\udd10\udb40\udd5f\udb40\udd5e\udb40\udd55\ufe0f' \n# trust no one\n```\n\n### Python\n\n#### Encode\n\n```py\nfrom emojito import encode, decode\n\nsecret = encode('\ud83c\udf79', 'trust no one')\nprint(secret) # **\ud83c\udf79\udb40\udd64\udb40\udd62\udb40\udd65\udb40\udd63\udb40\udd64\udb40\udd10\udb40\udd5e\udb40\udd5f\udb40\udd10\udb40\udd5f\udb40\udd5e\udb40\udd55\ufe0f**\n\ndecoded = decode(secret)\nprint(decoded) # trust no one\n```\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Encode text into emojis using Unicode steganography",
    "version": "0.1.1",
    "project_urls": {
        "Bug Tracker": "https://github.com/matijaoe/emojito/issues",
        "Homepage": "https://github.com/matijaoe/emojito",
        "Repository": "https://github.com/matijaoe/emojito.git"
    },
    "split_keywords": [
        "emoji",
        " encoding",
        " steganography",
        " unicode"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "09eefa9a4aee1a421ea5bdc1b2294b3959a47fd8d130b31845b381507fca457d",
                "md5": "084994c2214a5511dd25f3d00a8be5d3",
                "sha256": "2cd98530b39d834c267476958e96bc6cb58ceb7838ae87e5ec1cdb78a47368ad"
            },
            "downloads": -1,
            "filename": "emojito_py-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "084994c2214a5511dd25f3d00a8be5d3",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 4429,
            "upload_time": "2025-03-06T22:40:00",
            "upload_time_iso_8601": "2025-03-06T22:40:00.071075Z",
            "url": "https://files.pythonhosted.org/packages/09/ee/fa9a4aee1a421ea5bdc1b2294b3959a47fd8d130b31845b381507fca457d/emojito_py-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "320b1b4623a1a65ca82ee314cdffa8e1db9c5ccc666815abe6d78c163eac9c34",
                "md5": "3be894f2eefacc5b30dba6eb57daac76",
                "sha256": "d858d4ef34aa81f9e187cfb5d0b61762f863ffbd3a3c4abd2676da62d9445dd1"
            },
            "downloads": -1,
            "filename": "emojito_py-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "3be894f2eefacc5b30dba6eb57daac76",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 3313,
            "upload_time": "2025-03-06T22:40:01",
            "upload_time_iso_8601": "2025-03-06T22:40:01.231740Z",
            "url": "https://files.pythonhosted.org/packages/32/0b/1b4623a1a65ca82ee314cdffa8e1db9c5ccc666815abe6d78c163eac9c34/emojito_py-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-03-06 22:40:01",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "matijaoe",
    "github_project": "emojito",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "emojito-py"
}
        
Elapsed time: 0.50140s