fc-query(1)

fc-query1

Query font files

Usage

fc-query [-Vh] [{-b | --ignore-blanks}] [{-i index | --index index}] [{-f format | --format format}] [--version] [--help] font-file ...

Overview

fc-query queries font-file(s) using the normal fontconfig rules and prints out font pattern for each face found. If --index is given, only one face of each file is queried, otherwise all faces are queried.

Options

This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-b --ignore-blanks

Ignore blanks to compute languages

-i --index index

Only query face indexed index of each file.

-f --format format

Format output according to the format specifier format.

-V --version

Show version of the program and exit.

-h --help

Show summary of options.

font-file

Query font-file for font faces.

Return codes

fc-query returns error code 0 for successful parsing, or 1 if any errors occurred or if at least one font face could not be opened.

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 5 times.

  1. 6.0
  2. 7
  3. 8–9
  4. 10–11
  5. 12–13
  6. Arch

--format since Arch Linux 2026-11-01; --help since Arch Linux 2026-11-01; --ignore-blanks since Arch Linux 2026-11-01; --index since Arch Linux 2026-11-01; --version since Arch Linux 2026-11-01; -b since Debian 10 (Buster).

Author

This manual page was updated by Behdad Esfahbod <[email protected]>.

From fontconfig 2:2.18.3-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.