Skip to content
T2S

gfcli

gfcli is the command from the npm package google-font-cli. It uses google-webfonts-helper so you do not need a Google Fonts API key. You can fuzzy-search families, download TTF or WOFF2 files, install fonts on Linux, macOS, or Windows, or copy a Google Fonts stylesheet URL to the clipboard.

How it works

Section titled “How it works”
  1. Catalog: on first use (or after cache expiry), the tool downloads the full font list from https://gwfh.mranftl.com/api/fonts and stores it under ~/.gfcli/cache.json (24-hour TTL). Use --refresh-cache to bypass a valid cache.
  2. Per family: for downloads, installs, or CSS URLs, each family is resolved against that catalog, then details are fetched from https://gwfh.mranftl.com/api/fonts/{slug} (slug derived from the family name).
  3. Install vs download: gfcli install always uses TTF files from GWFH. gfcli download can pass --woff2 or --ttf. Saving to disk via the Node API follows the same rule: install / installAsync use TTF only; saveAt / saveAtAsync take a format argument.
  4. Platforms: Linux and macOS copy fonts into the user font directory. Windows uses a short script so fonts are registered the same way as a manual install.

Next steps

Section titled “Next steps”