Pilmoji is a fast and reliable emoji renderer for PIL.
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pilmoji-1.0.1.tar.gz
(6.4 kB
view hashes)