npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

google-font-cli

v3.2.1

Published

Fork of google-font-installer with bug fixes and maintenance updates

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

sevetinsevetin

Keywords

googlefontdownloadinstallcli

Readme

Google Font CLI

Open on npmx.dev Open on npmx.dev Open on npmx.dev

GitHub stars

how gfcli works

This tool uses google-webfonts-helper to access Google Fonts without requiring an API key.

Google Font CLI is a Node.js CLI & module that lets you Search, Download and Install fonts offered by Google Fonts.

Why use this?

  • Cross-platform: Automatic installation for Linux, macOS, and Windows
  • Smart Search: Fuzzy matching for font names makes finding fonts effortless
  • Developer Friendly: Use as a CLI or integrate as a Node.js library
  • Multiple Formats: Support for both TTF and WOFF2 formats

You can use it in two ways:

  • install the module system wide and use the Command Line Interface (CLI)
  • require the module in your project and use the APIs

Quick start

After installing it via npm or homebrew tap you can use the CLI!

# 1. Download
$ npm install -g google-font-cli

# 2. Install a font!
$ gfcli install "Open Sans" -v regular,700

Table of content

Font installation footnote

In Linux and OSX, the font will be installed in the user's font directory (~/.local/share/fonts for Linux, ~/Library/Fonts for OSX). In Windows, due to the fact that font installation require some register modifications, I prefered to create a little WScript (a windows script that use ActiveX windows interface) and spawn a cscript process to install the font in a 'windows native way'.

Installation

You can install gfcli using...

npm

or anything that can access npm such as bun!

$ npm install -g google-font-cli

homebrew using tap

$ brew install t2sever/tap/gfcli

CLI

From your terminal emulator, you can use the command gfcli

Caching

  • The Google Fonts metadata list is cached for 24h at ~/.gfcli/cache.json.
  • Use --refresh-cache on any command to force a fresh download.
  • If the cache is valid, commands skip the download step for faster startup.

Search a font

$ gfcli search [family_name]

The search is really permissive, so you can specify only few characters and view all the font families that contains these characters. Words order is also not important. For instance, search for Source Sans or Sans Source will produce the same result.

Download a font

$ gfcli download [family_name|"family1,family2"] [-d|--dest destination_folder] [-v|--variants comma_separated_variants] [--ttf|--woff2] [--refresh-cache]

If family_name will match more than one family, nothing will be downloaded: a list of alternatives will help you better specify the font family name.

Download command accepts these options:

  • -d or --dest let you specify the folder where to download the fonts. If this option is omitted the fonts will be download in the folder in which the command was called (or in the home directory if this folder is not writable by the user)
  • -v or --variants let you specify which variants of the font will be downloaded. You have to write each variant separated by the other with a comma. For example $ gfcli download Source Sans Pro -v 300,400. If omitted, all variants will be downloaded.
  • --ttf downloads the font in TTF format (default)
  • --woff2 downloads the font in WOFF2 format (optimized for web use)
  • Multiple families: pass a comma-separated list in quotes, e.g. $ gfcli download "Inter,Roboto" --woff2 -d ./fonts
  • --refresh-cache forces a fresh font list download and ignores the local cache

Install a font

$ gfcli install [family_name|"family1,family2"] [-v|--variants comma_separated_variants] [--refresh-cache]

If family_name will match more than one family, nothing will be installed: a list of alternatives will help you better specify the font family name.

Install command accepts only one option:

  • -v or --variants let you specify which variants of the font will be installed. You have to write each variant separated by the other with a comma. For example $ gfcli install Source Sans Pro -v 300,400. If omitted, all variants will be downloaded.
  • Multiple families: pass a comma-separated list in quotes, e.g. $ gfcli install "Inter,Roboto" -v 400,700
  • --refresh-cache forces a fresh font list download and ignores the local cache

Copy font CSS url

$ gfcli copy [family_name] [-v|--variants comma_separeted_variants]

If family_name will match more than one family, nothing will be copied: a list of alternatives will help you better specify the font family name.

Examples

Search the source keyword

$ gfcli search source

Search results for: "source"

 * Source Code Pro
    Category: monospace
    Variants: 200, 300, regular, 500, 600, 700, 900
    CSS Url: https://fonts.googleapis.com/css?family=Source+Code+Pro
 * Source Sans Pro
    Category: sans-serif
    Variants: 200, 200italic, 300, 300italic, regular, italic, 600, 600italic, 700, 700italic, 900, 900italic
    CSS Url: https://fonts.googleapis.com/css?family=Source+Sans+Pro
 * Source Serif Pro
    Category: serif
    Variants: regular, 600, 700
    CSS Url: https://fonts.googleapis.com/css?family=Source+Serif+Pro

Download Source Sans Pro 600 and 700italic

$ gfcli download source sans pro -v 600,700italic

Source Sans Pro variant 600 downloaded in /home/user/someFolder/SourceSansPro-600.ttf
Source Sans Pro variant 700italic downloaded in /home/user/someFolder/SourceSansPro-700italic.ttf

Download Inter in WOFF2 format

$ gfcli download inter --woff2

Inter variant regular downloaded in /home/user/someFolder/Inter-regular.woff2
Inter variant 100 downloaded in /home/user/someFolder/Inter-100.woff2
Inter variant 200 downloaded in /home/user/someFolder/Inter-200.woff2
...

Download Inter and Roboto in one command (WOFF2)

$ gfcli download "Inter,Roboto" --woff2 -d ./fonts

Install Inter and Roboto with selected variants

$ gfcli install "Inter,Roboto" -v regular,700

Force refresh of the cached font list

$ gfcli search inter --refresh-cache

Install Lato 100

$ gfcli install lato -v 100

Lato variant 100 downloaded in /home/user/.local/share/fonts/Lato-100.ttf

Copy font url for Work Sans variants 200, normal and 600

$ gfcli copy work sans -v 200,400,600

"work sans" font url has been copied to your clipboard.

(https://fonts.googleapis.com/css?family=Work+Sans:200,400,600 will be available in your clipboard)

Prerequisites

  • Node.js 20+ required.
  • Windows: run the CLI with administrative privileges when installing system fonts.

Documentation