Fontconfig (or fontconfig) is a free software^[6] program library designed to provide configuration, enumeration and substitution of fonts to other programs. Fontconfig was originally written and maintained by Keith Packard, and is currently maintained by Behdad Esfahbod.^[7]

This article has multiple issues. Please help improve it or discuss these issues on the talk page. (Learn how and when to remove these template messages) This article may be too technical for most readers to understand. (November 2009) This article relies excessively on references to primary sources. (June 2019)

Quick Facts Original author(s), Initial release ...

Original author(s)	Keith Packard
Initial release	18 December 2000; 23 years ago (2000-12-18)[1][2]
Stable release	2.15.0[3]  / 22 December 2023; 4 months ago (22 December 2023)
Preview release	2.13.96[4]  / 4 February 2022; 2 years ago (4 February 2022)
Repository	gitlab.freedesktop.org/fontconfig/fontconfig.git
Written in	C
Operating system	Unix-like systems
Type	Font handling library
License	MIT[5]
Website	fontconfig.org

Close

Fontconfig is typically used on graphical Linux (and other Unix-like) desktops, such as Xorg and Wayland, where it remains an important part of handling fonts.^[8] However, it is also sometimes used on other platforms, notably including Windows versions of software that use Pango for laying out and rendering text, such as GIMP.^[9]

End-users can use fontconfig, directly or indirectly, to customize and configure fonts on the system.

Applications can use fontconfig in two ways:

1. by querying it for the available fonts on the system, or
2. by querying it for a font matching certain parameters (comprising a pattern) as closely as possible.

To perform font matching, fontconfig stores typesetting information about all of the installed fonts, including the name of the font family, style, weight, dots per inch (DPI), and Unicode coverage. This information is also used to perform font substitution.

Fontconfig uses XML format for its configuration files. The document type definition (DTD) for fontconfig files is normally located at /etc/fonts/fonts.dtd.

The master configuration file - usually /etc/fonts/fonts.conf - references a few other configuration locations which may or may not exist:

• /etc/fonts/fonts.conf
• /etc/fonts/conf.d
• $XDG_CONFIG_HOME/fontconfig/conf.d
• $XDG_CONFIG_HOME/fontconfig/fonts.conf
• ~/.fonts.conf.d
• ~/.fonts.conf

A simple example of a configuration file:

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
    <!-- Enable antialiasing for all fonts -->
    <match target="font">
        <edit mode="assign" name="antialias"><bool>true</bool></edit>
    </match>
</fontconfig>

Fontconfig ships with eight command line utilities to manage and query fonts and the font configuration of the system:

• fc-list: Lists all fonts fontconfig knows about or all fonts matching a pattern.
• fc-match: Matches font-pattern (empty pattern by default) using the normal fontconfig matching rules to find the most appropriate font available.
• fc-cache: Creates a cache of all FreeType readable fonts in a specified directory or create a cache of all FreeType readable fonts from all directories specified in the configuration files.
• fc-cat: Reads the font information from cache files or related to font directories and emits it in ASCII form.
• fc-query: Querys font files and reports resulting pattern(s).
• fc-scan: Scans font files and directories and reports resulting pattern(s).
• fc-pattern: Lists best font(s) matching the supplied pattern(s).
• fc-validate: Validate font file(s) and reports the results.

• FreeType
• X logical font description
• Xft