---
name: "hb-info"
section: "1"
platform: "linux"
package: "harfbuzz-utils"
version: "15.0.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/hb-info"
---

# hb-info(1)

Query font information.

## NAME

hb-info - Query font information.

## DESCRIPTION

### Usage:

-

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

Query font information.

### Help Options:

- **-h**, **--help**

  Show help options

- **--help-all**

  Show 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*

  Set font file-name

- **-y**, **--face-index**=*index*

  Set face index (default: 0)

- **--face-loader**=*loader*

  Set face loader to use (default: ot)

-

  Supported face loaders are: ot/ft

- **--list-face-loaders**

  List available face loaders and quit

### Font-instance options:

- **--font-size**=*1*/2 integers or 'upem'

  Font size (default: upem)

- **--font-ppem**=*1*/2 integers

  Set x,y pixels per EM (default: 0; disabled)

- **--font-ptem**=*point-size*

  Set font point-size (default: 0; disabled)

- **--font-bold**=*1*/2 numbers; eg. 0.05

  Set synthetic bold (default: 0)

- **--font-grade**=*1*/2 numbers; eg. 0.05

  Set synthetic grade (default: 0)

- **--font-slant**=*slant* ratio; eg. 0.2

  Set synthetic slant (default: 0)

- **--font-funcs**=*impl*

  Set font functions implementation to use (default: ot)

-

  Supported font function implementations are: ot/ft

- **--list-font-funcs**

  List available font functions and quit

- **--ft-load-flags**=*integer*

  Set FreeType load-flags (default: 2)

### Variations options:

- **--named-instance**=*index*

  Set 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

  Set direction (default: ltr)

- **--script**=*ISO-15924* tag; eg. 'Latn'

  Set script (default: none)

- **--language**=*BCP* 47 tag; eg. 'en'

  Set language (default: $LANG)

- **--ot-script**=*tag*; eg. 'latn'

  Set OpenType script tag (default: none)

- **--ot-language**=*tag*; eg. 'ENG'

  Set OpenType language tag (default: none)

### Query options:

- **-a**, **--all**

  Show everything

- **--show-all**

  Show all short information (default)

- **--show-face-count**

  Show face count

- **--show-family**

  Show family name

- **--show-subfamily**

  Show subfamily name

- **--show-unique-name**

  Show unique name

- **--show-full-name**

  Show full name

- **--show-postscript-name**

  Show Postscript name

- **--show-version**

  Show version

- **--show-technology**

  Show technology

- **--show-unicode-count**

  Show Unicode count

- **--show-glyph-count**

  Show glyph count

- **--show-upem**

  Show Units-Per-EM

- **--show-extents**

  Show extents

- **--get-name**=*name* id; eg. '13'

  Get name

- **--get-style**=*style* tag; eg. 'wght'

  Get style

- **--get-metric**=*metric* tag; eg. 'hasc'

  Get metric

- **--get-baseline**=*baseline* tag; eg. 'hang'

  Get baseline

- **--get-meta**=*tag* tag; eg. 'dlng'

  Get meta information

- **--get-table**=*table* tag; eg. 'cmap'

  Get font table

- **--list-all**

  List all long information

- **--list-names**

  List names

- **--list-style**

  List style

- **--list-metrics**

  List metrics

- **--list-baselines**

  List baselines

- **-l**, **--list-tables**

  List tables

- **--list-unicodes**

  List characters

- **--list-glyphs**

  List glyphs

- **--list-scripts**

  List layout scripts

- **--list-features**

  List layout features

- **--list-variations**

  List variations

- **--list-palettes**

  List color palettes

- **--list-meta**

  List meta information

### Application Options:

- **-q**, **--quiet**

  Generate machine-readable output

- **--version**

  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-view/1.md), [hb-shape(1)](/hb-shape/1.md), [hb-raster(1)](/hb-raster/1.md), [hb-vector(1)](/hb-vector/1.md), [hb-subset(1)](/hb-subset/1.md), [hb-info(1)](/hb-info/1.md)

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