Pilmoji is an emoji renderer for Pillow, Python's imaging library.
Pilmoji comes equipped with support for both unicode emojis and Discord emojis.
- Discord emoji support
- Multi-line rendering support
- Emoji position and/or size adjusting
- Many built-in emoji sources
- Optional caching
You must have Python 3.8 or higher in order to install Pilmoji.
Installation can be done with pip:
$ pip install -U pilmojiOptionally, you can add the [requests] option to install requests
alongside Pilmoji:
$ pip install -U pilmoji[requests]The option is not required, instead if requests is not installed,
Pilmoji will fallback to use the builtin urllib.
You may also install from Github.
from pilmoji import Pilmoji
from PIL import Image, ImageFont
my_string = '''
Hello, world! 👋 Here are some emojis: 🎨 🌊 😎
I also support Discord emoji: <:rooThink:596576798351949847>
'''
with Image.new('RGB', (550, 80), (255, 255, 255)) as image:
font = ImageFont.truetype('arial.ttf', 24)
with Pilmoji(image) as pilmoji:
pilmoji.text((10, 10), my_string.strip(), (0, 0, 0), font)
image.show()
As seen from the example, Pilmoji defaults to the Twemoji emoji source.
If you prefer emojis from a different source, for example Microsoft, simply
set the source kwarg in the constructor to a source found in the
pilmoji.source module:
from pilmoji.source import MicrosoftEmojiSource
with Pilmoji(image, source=MicrosoftEmojiSource) as pilmoji:
...
It is also possible to create your own emoji sources via subclass.
If an emoji looks too small or too big, or out of place, you can make fine adjustments
with the emoji_scale_factor and emoji_position_offset kwargs:
pilmoji.text((10, 10), my_string.strip(), (0, 0, 0), font,
emoji_scale_factor=1.15, emoji_position_offset=(0, -2))Contributions are welcome. Make sure to follow PEP-8 styling guidelines.