HB-INFO(1)

📦
version 15.0.0 · 2 versions
, in arch rolling

🦋 HB-INFO(1) — hb-info — Query font information 🦋

🌸 NAME 🌸

hb-info — query font information. That's the whole name section, bestie, no cap. 💖

🎀 DESCRIPTION 🎀

✨ Usage ✨

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

Query font information.

💅 Help Options 💅

  • -h, --help — shows help options.
  • --help-all — shows all help options.
  • --help-face — options for the font face.
  • --help-font — options for the font instance.
  • --help-variations — options for font variations used.
  • --help-misc — miscellaneous options affecting queries.
  • --help-query — options to query the font instance.

🫶 Font-face options 🫶

  • --font-file=filename — sets the font file-name.
  • -y, --face-index=index — sets face index (default: 0).
  • --face-loader=loader — sets face loader to use (default: ot). Supported face loaders are: ot/ft.
  • --list-face-loaders — lists available face loaders and quits.

🧚 Font-instance options 🧚

  • --font-size=1/2 integers or 'upem' — sets font size (default: upem).
  • --font-ppem=1/2 integers — sets x,y pixels per EM (default: 0; disabled).
  • --font-ptem=point-size — sets font point-size (default: 0; disabled).
  • --font-bold=1/2 numbers; eg. 0.05 — sets synthetic bold (default: 0).
  • --font-grade=1/2 numbers; eg. 0.05 — sets synthetic grade (default: 0).
  • --font-slant=slant ratio; eg. 0.2 — sets synthetic slant (default: 0).
  • --font-funcs=impl — sets font functions implementation to use (default: ot). Supported font function implementations are: ot/ft.
  • --list-font-funcs — lists available font functions and quits.
  • --ft-load-flags=integer — sets FreeType load-flags (default: 2).

🌈 Variations options 🌈

  • --named-instance=index — sets named-instance index (default: none).
  • --variations=list — 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 🦋

  • --direction=ltr/rtl/ttb/btt — sets direction (default: ltr).
  • --script=ISO-15924 tag; eg. 'Latn' — sets script (default: none).
  • --language=BCP 47 tag; eg. 'en' — sets language (default: $LANG).
  • --ot-script=tag; eg. 'latn' — sets OpenType script tag (default: none).
  • --ot-language=tag; eg. 'ENG' — sets OpenType language tag (default: none).

👑 Query options 👑

  • -a, --all — shows everything.
  • --show-all — shows all short information (default).
  • --show-face-count — shows face count.
  • --show-family — shows family name.
  • --show-subfamily — shows subfamily name.
  • --show-unique-name — shows unique name.
  • --show-full-name — shows full name.
  • --show-postscript-name — shows Postscript name.
  • --show-version — shows version.
  • --show-technology — shows technology.
  • --show-unicode-count — shows Unicode count.
  • --show-glyph-count — shows glyph count.
  • --show-upem — shows Units-Per-EM.
  • --show-extents — shows extents.
  • --get-name=name id; eg. '13' — gets name.
  • --get-style=style tag; eg. 'wght' — gets style.
  • --get-metric=metric tag; eg. 'hasc' — gets metric.
  • --get-baseline=baseline tag; eg. 'hang' — gets baseline.
  • --get-meta=tag tag; eg. 'dlng' — gets meta information.
  • --get-table=table tag; eg. 'cmap' — gets font table.
  • --list-all — lists all long information.
  • --list-names — lists names.
  • --list-style — lists style.
  • --list-metrics — lists metrics.
  • --list-baselines — lists baselines.
  • -l, --list-tables — lists tables.
  • --list-unicodes — lists characters.
  • --list-glyphs — lists glyphs.
  • --list-scripts — lists layout scripts.
  • --list-features — lists layout features.
  • --list-variations — lists variations.
  • --list-palettes — lists color palettes.
  • --list-meta — lists meta information.

🍓 Application Options 🍓

  • -q, --quiet — generates machine-readable output.
  • --version — shows 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 🔗

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

💖 HarfBuzz 15.0.0, October 2026 — HB-INFO(1), over and out bestie! 💖

📦 where this page comes from