---
id: emot
version: "3.1"
license: GNU GENERAL PUBLIC LICENSE
license_treatment: unclear
maintenance: dormant
---

# emot — Emoji and Emoticons detection package for Python

License: unclear · Maintenance: dormant · Downloads: 272.2K/mo

## What it is and what it does

Emot is a Python library that identifies emojis and emoticons within text strings and returns structured data about each match. It parses Unicode emoji characters and ASCII emoticon patterns (like :-) and :-() from input text, reporting the matched symbols, their byte positions, and their semantic meanings in a dictionary with a success flag.

The library generates detection patterns dynamically from an internal emoji database each time an object is instantiated, allowing customization by editing the database file. Version 3.0 added bulk processing functions that use multiprocessing to handle large text datasets, distributing work across available CPU cores (defaulting to half the system total) for potential performance gains on many strings at once.

Use it for:

- Sentiment analysis pipelines that need to extract and interpret emojis as sentiment signals from social media text.
- Content moderation systems that identify and locate emojis or emoticons in user-generated text for filtering or flagging.
- Data preprocessing for NLP tasks where emoji presence or meaning should be captured as features or metadata.
- Bulk text processing of large datasets where extracting all emoji/emoticon occurrences and their positions is required.
- Text annotation or enrichment workflows that map emojis to their Unicode names for downstream analysis or display.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Extracts emojis and emoticons from text, returning their positions, Unicode names, and meanings in a dictionary format.

Yes, if you need straightforward emoji and emoticon extraction with no external dependencies. However, exercise caution: the project is dormant (last release 2021-08-02), the GPL license terms are unclear, and Python version support is unspecified. Suitable for one-off scripts or legacy systems, but risky for new production code without verifying GPL compliance and testing against your target Python version.

## Install

pip install emot
uv add emot
poetry add emot

## Installing emot

Before you install: Low friction install with no runtime dependencies. Maintenance is dormant—last release was 2021-08-02, though the repository remains active with 197 stars and a final commit in 2023-11-02.

License in practice: License treatment is unclear; the raw license states 'GNU GENERAL PUBLIC LICENSE' but no SPDX identifier is provided, making the exact terms and compatibility obligations ambiguous.

Quickstart:

import emot
emot_obj = emot.core.emot()
text = "I love python ☮ 🙂 ❤ :-) :-( :-)))"
result = emot_obj.emoji(text)
print(result)  # {'value': ['☮', '🙂', '❤'], 'location': [[14, 15], [16, 17], [18, 19]], 'mean': [':peace_symbol:', ':slightly_smiling_face:', ':red_heart:'], 'flag': True}

Verify before relying:

- Whether the GPL license is version 2, 3, or unspecified, and what that means for derivative works or commercial use.
- Current compatibility with modern Python versions and whether Python 3.X support extends to recent releases.
- Whether the multiprocessing bulk functions actually deliver measurable speedup on typical datasets.

## Package facts

- License: GNU GENERAL PUBLIC LICENSE (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 272.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

emoji extraction from text, emoticon detection, emoji parser, emoticon parser, emoji location finder, text emoji analysis, emoticon meaning lookup, emoji-detection, text-parsing, nlp-preprocessing

[View on SkillFed](https://skillfed.io/packages/emot) · [View on PyPI](https://pypi.org/project/emot/)