Skip to main content

Emoji for Python

Project description

Emoji for Python. This project was inspired by kyokomi.


The entire set of Emoji codes as defined by the Unicode consortium is supported in addition to a bunch of aliases. By default, only the official list is enabled but doing emoji.emojize(language='alias') enables both the full list and aliases.

>>> import emoji
>>> print(emoji.emojize('Python is :thumbs_up:'))
Python is 👍
>>> print(emoji.emojize('Python is :thumbsup:', language='alias'))
Python is 👍
>>> print(emoji.demojize('Python is 👍'))
Python is :thumbs_up:
>>> print(emoji.emojize("Python is fun :red_heart:"))
Python is fun 
>>> print(emoji.emojize("Python is fun :red_heart:", variant="emoji_type"))
Python is fun ❤️ #red heart, not black heart
>>> print(emoji.is_emoji("👍"))

By default, the language is English (language='en') but also supported languages are:

  • Spanish ('es')

  • Portuguese ('pt')

  • Italian ('it')

  • French ('fr')

  • German ('de')

  • Farsi/Persian ('fa')

  • Indonesian ('id')

  • Simplified Chinese ('zh')

  • Japanese ('ja')

  • Korean ('ko')

  • Russian ('ru')

  • Arabic ('ar')

  • Turkish ('tr')

>>> print(emoji.emojize('Python es :pulgar_hacia_arriba:', language='es'))
Python es 👍
>>> print(emoji.demojize('Python es 👍', language='es'))
Python es :pulgar_hacia_arriba:
>>> print(emoji.emojize("Python é :polegar_para_cima:", language='pt'))
Python é 👍
>>> print(emoji.demojize("Python é 👍", language='pt'))
Python é :polegar_para_cima:


Via pip:

$ python -m pip install emoji --upgrade

From master branch:

$ git clone
$ cd emoji
$ python -m pip install .


$ git clone
$ cd emoji
$ python -m pip install -e .\[dev\]
$ pytest
$ coverage run -m pytest
$ coverage report

The utils/ is used to generate unicode_codes/ Generally speaking it scrapes a table on the Unicode Consortium’s website with BeautifulSoup and prints the contents to stdout as a Python dictionary. For more information take a look in the utils/ file.


Taehoon Kim / @carpedm20

Kevin Wurster / @geowurster


Tahir Jalilov / @TahirJalilov

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

emoji-2.12.1.tar.gz (442.0 kB view hashes)

Uploaded Source

Built Distribution

emoji-2.12.1-py3-none-any.whl (431.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page