FC-MATCH(1)

fc-match — match available fonts, bestie edition 🎀 (FC-MATCH(1))

NAME 🎀

fc-match — match available fonts. That's the whole vibe: you hand it a pattern, it goes shopping through your fontconfig and finds the best font available. 💅

SYNOPSIS ✨

fc-match [ -asvVh ] [ --all ] [ --sort ] [ --verbose ]
         [ [ -f format ] [ --format format ] ]
         [ --version ] [ --help ]
         [ pattern [ element... ] ]

DESCRIPTION 💖

Okay so fc-match matches pattern (empty pattern by default) using the normal fontconfig matching rules to find the best font available. It's giving font matchmaker, no cap. 🦋

If --sort is given, the sorted list of best matching fonts is displayed. The --all option works like --sort except that no pruning is done on the list of fonts. Yes bestie, no pruning — it does not trim the list. ✨

If any elements are specified, only those are printed. Otherwise short file name, family, and style are printed, unless verbose output is requested. That's the default little trio. 🫶

OPTIONS 👑

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

• -a, --all — Displays sorted list of best matching fonts, but do not do any pruning on the list. It's the --sort vibe with zero trimming, periodt. 💅
• -s, --sort — Displays sorted list of best matching fonts. Sorted, cute, done. 🌸
• -v, --verbose — Print verbose output of the whole font pattern for each match, or elements if any is provided. It's giving full lore. 😭
• -f, --format format — Format output according to the format specifier format. Your output, your rules. ✨
• -V, --version — Show version of the program and exit. Bye bestie. 👋
• -h, --help — Show summary of options. The classic "help me help you" moment. 🫶
• pattern — Displays fonts matching pattern (uses empty pattern by default). Empty pattern is the default, iykyk. 🎀
• element — If set, the element property is displayed for matching fonts. Only the elements you ask for, bestie. 💜

EXAMPLES 🔥

fc-match sans

Display the best matching font categorized into sans-serif generic family, filtered by current locale. 💅

fc-match sans:lang=en

Display the best matching font categorized into sans-serif generic family, filtered by English language. 🌈

fc-match sans:lang=en:weight=bold

Display the best matching font categorized into sans-serif generic family, filtered by English language and weight is bold. Bold era. 🔥

SEE ALSO 📚

Bestie, go touch grass in the rest of fontconfig:

• fc-list(1)
• FcFontMatch(3)
• FcFontSort(3)
• FcPatternFormat(3)
• fc-cat(1)
• fc-cache(1)
• fc-pattern(1)
• fc-query(1)
• fc-scan(1)

The fontconfig user's guide: https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html — the full lore drop, iykyk. 🧚

AUTHOR 💐

This manual page was updated by Patrick Lam <plam@csail.mit.edu>. Give them their flowers. 💖

---

Signing off from the FC-MATCH(1) page, dated Aug 13, 2008 — stay matched, bestie. 💖🦋