Scroll to navigation

HB-INFO(1) User Commands HB-INFO(1)

NAME

hb-info - "$(util/hb-info.1 --help | head -n 3 | tail -n 1)"

DESCRIPTION

Usage:

hb-info [OPTION?] [FONT-FILE]

Query font information.

Help Options:

Show help options
Show all help options
Options for the font face
Options for the font instance
Options for font variations used
Miscellaneous options affecting queries
Options to query the font instance

Font-face options:

Set font file-name
Set face index (default: 0)
Set face loader to use (default: ot)
Supported face loaders are: ot/ft
List available face loaders and quit

Font-instance options:

Font size (default: upem)
Set x,y pixels per EM (default: 0; disabled)
Set font point-size (default: 0; disabled)
Set synthetic bold (default: 0)
Set synthetic grade (default: 0)
Set synthetic slant (default: 0)
Set font functions implementation to use (default: ot)
Supported font function implementations are: ot/ft
List available font functions and quit
Set FreeType load-flags (default: 2)

Variations options:

Set named-instance index (default: none)
Comma-separated list of font variations
Variations are set globally. The format for specifying variation settings follows. All valid CSS font-variation-settings values other than 'normal' and 'inherited' are also accepted, though, not documented below.
The format is a tag, optionally followed by an equals sign, followed by a number. For example:
"wght=500" "slnt=-7.5"

Miscellaneous options:

Set direction (default: ltr)
Set script (default: none)
Set language (default: $LANG)
Set OpenType script tag (default: none)
Set OpenType language tag (default: none)

Query options:

Show everything
Show all short information (default)
Show face count
Show family name
Show subfamily name
Show unique name
Show full name
Show Postscript name
Show version
Show technology
Show Unicode count
Show glyph count
Show Units-Per-EM
Show extents
Get name
Get style
Get metric
Get baseline
Get meta information
Get font table
List all long information
List names
List style
List metrics
List baselines
List tables
List characters
List glyphs
List layout scripts
List layout features
List variations
List color palettes
List meta information

Application Options:

Generate machine-readable output
Show version numbers

Queries font file for various information. If no query option is specified, --show-all is assumed.

EXIT CODES

0: Success.
1: Option parsing failed.
2: Failed loading font face.
4: Failed setting font functions.

ENVIRONMENT

HB_FACE_LOADER=face-loader; Overrides the default face loader.
HB_FONT_FUNCS=font-funcs; Overrides the default font-funcs.

SEE ALSO

hb-view(1), hb-shape(1), hb-subset(1), hb-info(1)

Find more information or report bugs at <https://github.com/harfbuzz/harfbuzz>

September 2025 HarfBuzz 11.4.5