freetype-py

What it is and what it does

freetype-py is a high-level Python wrapper around the FreeType font rendering engine. It lets you load font files (TrueType, OpenType), query glyph metrics and outlines, and rasterize text to bitmaps. The package ships with prebuilt FreeType binaries for common platforms (Windows, macOS, Linux on x86_64 and aarch64), so most installations work out of the box via pip.

For less common architectures or when you need to compile from source, you can build FreeType yourself using the included build script, though this requires a C/C++ toolchain and CMake. The library is stable and production-ready, but development is dormant. It has no runtime dependencies beyond FreeType itself and works with Python 3.7 and later.

Use it for:

• Render text to bitmap images for game engines, image processing pipelines, or custom UI rendering without relying on system font rasterizers.
• Extract glyph outlines and metrics from font files for vector graphics, font analysis, or custom text layout implementations.
• Build font inspection tools that read and display TrueType/OpenType font properties, character coverage, and glyph data.
• Create bitmap fonts or pre-rendered text atlases for performance-critical graphics applications.
• Freeze desktop applications with PyInstaller while ensuring FreeType binaries are bundled correctly.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides Python bindings to the FreeType font rendering library, enabling you to load TrueType and OpenType fonts, access glyph metrics and outlines, and render text to bitmaps.

Yes, if you need direct control over font rendering or glyph access. The prebuilt wheels make installation frictionless on mainstream platforms. Dormant maintenance is not a blocker for stable, mature font-binding code, but verify that the version meets your Python and architecture requirements before committing. No known vulnerabilities.

Install

freetype-py on PyPI

pip install freetype-py

uv add freetype-py

poetry add freetype-py

Installing freetype-py

Before you install

Medium friction: prebuilt wheels cover common platforms (x86_64, aarch64, macOS universal, Windows), but non-standard architectures or --no-binary installs require compiling FreeType from source with CMake and a C/C++ toolchain. Maintenance is dormant (last release 715 days ago), though the codebase remains stable and archived status is false.

License in practice

Permissive license treatment allows commercial and private use without restriction, making it suitable for proprietary applications.

Quickstart

pip install freetype-py

import freetype
face = freetype.Face("Vera.ttf")
face.set_char_size(48 * 64)
face.load_char('S')
bitmap = face.glyph.bitmap
print(bitmap.buffer)

On non-standard architectures or with --no-binary, requires CMake, C/C++ compiler, and system development headers; on Windows, FreeType DLL must be named 'freetype.dll' and placed in PATH or working directory.

Verify before relying

• Whether the bundled FreeType binary includes Harfbuzz support by default in wheel distributions.
• Current compatibility with Python versions beyond 3.7 (requires_python states >=3.7, but latest Python support level is not explicitly versioned).

Package facts

Evidence: freetype_py-2.5.1-py3-none-macosx_10_9_universal2.whl; freetype_py-2.5.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; freetype_py-2.5.1-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl; freetype_py-2.5.1-py3-none-musllinux_1_1_aarch64.whl; freetype_py-2.5.1-py3-none-musllinux_1_1_x86_64.whl; freetype_py-2.5.1-py3-none-win_amd64.whl

Keywords: freetype, font

Tags

More Graphics packages