OS Manuals

/opt/chainguard/gftools/bin/gftools-add-font

Google Fonts Tools: build, fix, check and package fonts for the Google Fonts library

From gftools 0.10.8-r0 (os), captured 2026-11-05 by running gftools-add-font --help (exit 0). permalink

usage: gftools-add-font [-h] [--min_pct MIN_PCT] [--min_pct_ext MIN_PCT_EXT]
                        [--min_relaxed_pct MIN_RELAXED_PCT] [--lang LANG]
                        [--github_url GITHUB_URL]
                        directory

Utility to setup a font for addition to Piper. Generate METADATA.pb files for font families.
METADATA.pb files are used to serve the families on http://fonts.google.com. Font families are
stored in this repo by license type. The following directories contain font families: ../fonts/ofl
../fonts/apache ../fonts/ufl Generating a METADATA.pb file for a new family: 1. Determine the
family's license type, ofl, ufl or apache 2. Create a new folder under the license type directory
3. Name the folder so it's the family name, all lowercase and no spaces. 4. Run the following:
gftools add-font /path/to/new/family 5. Update the category field in the generated METADATA.pb
file. Generating a METADATA.pb file for an existing family: 1. run the following: gftools add-font
/path/to/existing/family

positional arguments:
  directory             A directory containing a font family

options:
  -h, --help            show this help message and exit
  --min_pct MIN_PCT     What percentage of subset codepoints have to be supported for a non-ext
                        subset.
  --min_pct_ext MIN_PCT_EXT
                        What percentage of subset codepoints have to be supported for a -ext
                        subset.
  --min_relaxed_pct MIN_RELAXED_PCT
                        What percentage of subset codepoints have to be supported for a relaxed
                        subset (math, symbols).
  --lang LANG           Path to lang metadata package
  --github_url GITHUB_URL
                        The font family's github url which gets written to new description files
Options (6)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
--min_pct MIN_PCTWhat percentage of subset codepoints have to be supported for a non-ext subset.help
--min_pct_ext MIN_PCT_EXTWhat percentage of subset codepoints have to be supported for a -ext subset.help
--min_relaxed_pct MIN_RELAXED_PCTWhat percentage of subset codepoints have to be supported for a relaxed subset (math, symbols).help
--lang LANGPath to lang metadata packagehelp
--github_url GITHUB_URLThe font family's github url which gets written to new description fileshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.