Skip to content
OpenType font loader for LuaTeX
Lua Other
  1. Lua 99.6%
  2. Other 0.4%
Branch: master
Clone or download
Pull request Compare This branch is 433 commits ahead of lualatex:master.
Ulrike Fischer
Latest commit d08c120 Sep 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
bugs new harf-files for harftex Apr 27, 2019
doc tag with new version Sep 14, 2019
oldstuff development 2.9. for history look at dev-2.9 branch Oct 3, 2018
scripts tag with new version Sep 14, 2019
src tag with new version Sep 14, 2019
support No longer bundle texmf Sep 12, 2019
testfiles-fontspec corrected ebgaramond testfiles Dec 13, 2018
testfiles-latex-TU corrected tests after harf update/missingchars Jun 29, 2019
testfiles-luahbtex clean up Feb 21, 2019
testfiles-unicode-math corrected testfiles May 18, 2019
testfiles delete unneeded harftex.tlg Sep 18, 2019
todoinfos started list of context files Oct 19, 2018
trials store test file Feb 24, 2019
.gitignore No longer bundle texmf Sep 12, 2019
.travis.yml Better Travis tag handling Sep 12, 2019
COPYING [*] add license text as toplevel file COPYING Mar 7, 2014
NEWS prepare next upload Sep 14, 2019 update readme Sep 10, 2019
build.lua adapt to next ctan upload, change version Sep 14, 2019
buildinfo.txt prepare next upload Sep 14, 2019
config-fontspec.lua development 2.9. for history look at dev-2.9 branch Oct 3, 2018
config-harftex.lua rename luahbtex to harftex Jun 9, 2019
config-latex-TU.lua development 2.9. for history look at dev-2.9 branch Oct 3, 2018
config-loader-reference.lua imported context files Aug 13, 2019
config-loader-unpackaged.lua development 2.9. for history look at dev-2.9 branch Oct 3, 2018
config-plain.lua development 2.9. for history look at dev-2.9 branch Oct 3, 2018
config-unicode-math.lua imported new unicode testfiles Feb 20, 2019
ctan.ann prepare next upload Sep 14, 2019
texlive.profile development 2.9. for history look at dev-2.9 branch Oct 3, 2018 Correct latex-dev name Sep 12, 2019

The Luaotfload Package

Version: 3.002 Date: 2019-08-11 License: GNU GPLv2

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

Luaotfload may be loaded in Plain LuaTeX with \input luaotfload.sty. In LuaLaTeX it is loaded by default. LuaLaTeX 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.


The current luaotfload needs luatex 1.10 (present in TeXLive 2019 and a current MiKTeX). The development targets the engines luatex and luahbtex and the version that will be in TeXLive 2020.

Other luatex versions and luatex engine variants are not officially supported.

Development versions

The main ongoing development is in the dev branch. The l3build setup will install these files in the latex-dev part of the texmf, they can then be tested with lualatex-dev Very experimental stuff is in the various other dev branches.

Pull requests

The experimental branches are normally the newest but can have a quite short life. If a pull request is made against such a branch it gets automatically closed when the branch is closed. In general it is therefore better to make pull requests against the dev branch.


GitHub issues mailing list

Issues can be reported at the issue tracker.

The development for LuaLaTeX is discussed on the lualatex-dev mailing list. See for details.

Responsible Persons

The following people have contributed to this package.

name contact
Khaled Hosny
Elie Roux
Will Robertson
Philipp Gesang
Dohyun Kim
Reuben Thomas
Joseph Wright
Manuel Pégourié-Gonnard
Olof-Joachim Frahm
Patrick Gundlach
Philipp Stephani
David Carlisle
Yan Zhou @zhouyan
Ulrike Fischer
Marcel Krüger


Here are the recommended installation methods (preferred first).

  1. Install the current version with the package management tools of your TeX system.

  2. If you want to try the development version download the texmf folder in the development branch.


The luaotfload bundle, as a derived work of ConTeXt, 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.
You can’t perform that action at this time.