Home

✦ nerd-fonts-installer wiki

Nerd Fonts, installed the boring way.

🌐 Website  •  📦 Releases  •  🐞 Issues  •  📄 README

---

nerd-fonts-installer is a small, scriptable Go CLI that installs Nerd Fonts from a config file or an interactive terminal picker. It downloads the release archives, verifies them, extracts only the font files, and refreshes your font cache.

The README is the tour. This wiki is the manual.

🧭 Start here

Page	What's in it
🚀 Installation	Snap, release tarballs, building from source, verifying downloads.
⚙️ Configuration	Every key, every discovery path, every format.
🖱️ Interactive Picker	Keybindings, icon modes, how the two-step flow works.
🚩 CLI Reference	Flags, environment variables, exit codes.
🍳 Recipes	Dotfiles, bootstrap scripts, Ansible, CI, containers, remote boxes.
🩹 Troubleshooting	Every error message and what to do about it.
❓ FAQ	Short answers to the common questions.
🏗️ Architecture	Package map, install pipeline, and the security model.
🤝 Contributing	Local checks, conventions, and how changes land.

⏱️ 60-second version

# 1. install the tool
sudo snap install nerd-fonts-installer --classic

# 2. describe what you want
mkdir -p ~/.config/nerd-fonts-installer
cat > ~/.config/nerd-fonts-installer/config.yaml <<'YAML'
release: latest
destination: ~/.local/share/fonts/NerdFonts
refresh_font_cache: true
families:
  - JetBrainsMono
  - Hack
  - FiraCode
YAML

# 3. look before you leap, then install
nerd-fonts-installer --dry-run
nerd-fonts-installer

Then pick JetBrainsMono Nerd Font (or whichever family you installed) in your terminal or editor and restart it.

No config yet? nerd-fonts-installer --interactive will build one for you.

🎯 What it is — and isn't

It is a repeatable installer: declarative, checksum-verified, scriptable, and safe to run twice.

It isn't a font manager. It does not preview glyphs, uninstall families, or manage non-Nerd fonts. It downloads Nerd Font archives and puts the font files where you asked.