pillow-yaff

YAFF bitmap font support for Pillow, as a standalone package that requires no changes to Pillow itself.

YAFF is a human-readable bitmap font format supporting proportional glyph widths and per-glyph kerning.

pillow-yaff provides a font object that implements the same duck-typed interface Pillow's own font classes do (getbbox, getlength, getmask, getmask2), so it can be passed directly as the font= argument to PIL.ImageDraw or PIL.ImageText on an unmodified, pip-installed Pillow.

Usage

import pillow_yaff
from PIL import Image, ImageDraw

font = pillow_yaff.load("my_font.yaff")

im = Image.new("RGB", (100, 30), "white")
draw = ImageDraw.Draw(im)
draw.text((5, 5), "Hello", fill="black", font=font)
im.save("out.png")

pillow_yaff.load() accepts a path (str, bytes, or os.PathLike) or an open binary file object.

Requirements

• Pillow >= 12.0.0 (needs PIL.ImageText)
• Python >= 3.10

Development

pip install -e .[test]
pytest

CI (.github/workflows/test.yml) runs the test suite on Python 3.10-3.14 across Linux/macOS/Windows on every push and pull request, and builds the sdist/wheel to catch packaging errors early.