pilmoji 1.0.0

Pilmoji is a fast and reliable emoji renderer for PIL.

Pilmoji

Pilmoji is an emoji renderer for Pillow, Python's imaging library.
It supports not only unicode emojis, but also Discord emojis.

Pilmoji uses twemoji for unicode emojis.
For Discord emojis, Pilmoji will send a request to Discord's CDN.
Everything is cached, to ensure fast results.

Features

• Asynchronous support
• Multi-line support
• Discord emoji support
• Caching

Asynchronous Support

Pilmoji has both synchronous (requests) and asynchrounous (aiohttp) support.

Installation

Pilmoji should be installed using pip:

pip install pilmoji

Installing from Github will most likely fail.

Examples

Basic usage

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()

Result

Async usage

import asyncio
from pilmoji import AsyncPilmoji
from PIL import Image, ImageFont

my_string = '''
Hello, world! 👋 Here are some emojis: 🎨 🌊 😎
I also support Discord emoji: <:rooThink:596576798351949847>
'''


async def main():
    with Image.new('RGB', (550, 80), (255, 255, 255)) as image:
        font = ImageFont.truetype('arial.ttf', 24)

        async with AsyncPilmoji(image) as pilmoji:
            await pilmoji.text((10, 10), my_string.strip(), (0, 0, 0), font)

        image.show()


asyncio.run(main())

Results are the exact same.

Notes

• [async] If you're running PIL in an executor, use the sync version of Pilmoji instead.
• [async] It is not recommended to run PIL in asynchronous conditions (PIL is blocking.)
  • If you really have to, run the manipulation in an executor.