CTAN Comprehensive TeX Archive Network

Directory macros/luatex/generic/luaotfload


The Luaotfload Package


DATE: 2024-02-14


Luaotfload is an adaptation of the Cont font loading system for the Plain and formats. It allows OpenType fonts to be loaded with font features accessible using an extended font request syntax while providing compatibility with . By indexing metadata in a database it facilitates loading fonts by their proper names instead of file names.

Luaotfload may be loaded in Plain Lua with "input luaotfload.sty" and in Lua with "usepackage{luaotfload}". Lua users may be interested in the fontspec package which provides a high-level interface to the functionality provided by this package.

Please see the documentation luaotfload.pdf for more information.


This package is currently maintained at https://github.com/latex3/luaotfload.

Issues can be reported at the issue tracker.

The development for Lua is discussed on the lualatex-dev mailing list. See http://www.tug.org/mailman/listinfo/lualatex-dev for details.

Responsible Persons

The following people have contributed to this package.

  • Khaled Hosny <khaledhosny@eglug.org>
  • Elie Roux <elie.roux@telecom-bretagne.eu>
  • Will Robertson <will.robertson@latex-project.org>
  • Philipp Gesang <phg@phi-gamma.net>
  • Dohyun Kim <nomosnomos@gmail.com>
  • Reuben Thomas https://github.com/rrthomas
  • Joseph Wright <joseph.wright@morningstar2.co.uk>
  • Manuel Pégourié-Gonnard <mpg@elzevir.fr>
  • Olof-Joachim Frahm <olof@macrolet.net>
  • Patrick Gundlach <gundlach@speedata.de>
  • Philipp Stephani <stphilipp@yahoo.de>
  • David Carlisle <d.p.carlisle@gmail.com>
  • Yan Zhou @zhouyan
  • Ulrike Fischer <fischer@troubleshooting-tex.de>
  • Marcel Krüger https://github.com/zauguin


  1. Install the current version with the package management tools of your system. If you want to install manually: there is a tds-zip file which can be unpacked in a texmf tree.
  1. If you want to try the development version download the texmf folder in the development branch. at https://github.com/latex3/luaotfload
  2. Manual installation:
    • luaotfload-tool.lua belongs in scripts/luatex/luaotfload
    • fontloader-reference-load-order.tex and fontloader-reference-load-order.lua are source files and can got in source or doc
    • the other lua-files and the sty belong in tex/luatex/luaotfload
    • luaotfload.conf.5 and luaotfload-tool.1 belong in doc/man
    • the rest in doc/luatex/luaotfload

## Documentation

  • The main documentation is luaotfload-latex.pdf.
  • luaotfload.conf.5 and luaotfload-tool.1 are man-files, their sources are the rst-files.
  • README.md, NEWS and COPYING contain what their name says.
  • The rest are input files.


The luaotfload bundle, as a derived work of Cont, is distributed under the GNU GPLv2 license:


This license requires the license itself to be distributed with the work. For its full text see the documentation in luaotfload.pdf.


    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License
    as published by the Free Software Foundation; version 2.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    GNU General Public License for more details.
    See headers of each source file for copyright details.

Download the contents of this package in one zip archive (1.9M).

luaotfload – OpenType ‘loader’ for Plain and

The package adopts the TrueType/OpenType Font loader code provided in Cont, and adapts it to use in Plain and . It works under Lua only.

Version3.28 2024-02-14
LicensesGNU General Public License, version 2
Copyright2009–2024 PRAGMA ADE / Cont Development Team
MaintainerUlrike Fischer
Philipp Gesang
Marcel Krüger
The Project Team
Élie Roux
Manuel Pégourié-Gonnard (inactive)
Khaled Hosny (inactive)
Will Robertson (inactive)
TDS archiveluaotfload.tds.zip
Contained inTeX Live as luaotfload
MiKTeX as luaotfload
TopicsFont use
Guest Book Sitemap Contact Contact Author