Installation

🚀 Installation

nerd-fonts-installer ships as a single static binary. There is no runtime to install, no Python, no Node. Linux and macOS, amd64 and arm64.

---

📦 Snap (Linux)

sudo snap install nerd-fonts-installer --classic

The snap uses classic confinement because the tool writes into your real user font directory and shells out to fc-cache. Strict confinement would sandbox it away from both.

Channels:

Channel	Tracks
stable	v* release tags
edge	every push to main

sudo snap install nerd-fonts-installer --classic --edge   # bleeding edge
sudo snap refresh nerd-fonts-installer                    # update later

---

📥 Release tarball (Linux and macOS)

Every release publishes archives plus a checksums.txt. The moving latest release keeps stable asset names, so the URLs below never change and are safe to hard-code in a setup script.

System	Asset
🐧 Linux · Intel/AMD	nerd-fonts-installer_latest_linux_amd64.tar.gz
🐧 Linux · ARM64	nerd-fonts-installer_latest_linux_arm64.tar.gz
🍎 macOS · Intel	nerd-fonts-installer_latest_darwin_amd64.tar.gz
🍎 macOS · Apple Silicon	nerd-fonts-installer_latest_darwin_arm64.tar.gz

base=https://github.com/worxbend/nerd-fonts-installer/releases/download/latest
file=nerd-fonts-installer_latest_linux_amd64.tar.gz

curl -LO "$base/$file"
curl -LO "$base/checksums.txt"

# verify before you extract
sha256sum --check --ignore-missing checksums.txt   # Linux
shasum -a 256 --check --ignore-missing checksums.txt   # macOS

tar -xzf "$file"
cd "${file%.tar.gz}"

Put it on your PATH:

chmod +x nerd-fonts-installer
mkdir -p ~/.local/bin
mv nerd-fonts-installer ~/.local/bin/

If ~/.local/bin is not on your PATH yet, add this to ~/.bashrc, ~/.zshrc, or your shell's equivalent:

export PATH="$HOME/.local/bin:$PATH"

📌 Pinning a version

Prefer a specific version over latest when you want the tool itself to be reproducible:

tag=v1.0.7
base=https://github.com/worxbend/nerd-fonts-installer/releases/download/$tag
curl -LO "$base/nerd-fonts-installer_${tag}_linux_amd64.tar.gz"

Check the releases page for the exact asset names on a given tag.

---

🔨 From source

Requires Go 1.26 or newer. Nothing else.

git clone https://github.com/worxbend/nerd-fonts-installer
cd nerd-fonts-installer
go build -trimpath -o bin/nerd-fonts-installer ./cmd/nerd-fonts-installer

Smoke test:

./bin/nerd-fonts-installer --version
./bin/nerd-fonts-installer --config config.example.yaml --dry-run

Or install straight into $GOBIN:

go install github.com/worxbend/nerd-fonts-installer/cmd/nerd-fonts-installer@latest

Note

A go install build reports dev for --version, because the version, commit, and date are injected by the release workflow's -ldflags.

---

✅ Verify the install

nerd-fonts-installer --version
nerd-fonts-installer --font-names | head

The second command reaches the GitHub API and prints family names for the latest release — if it works, downloads will too.

---

🗑️ Uninstall

sudo snap remove nerd-fonts-installer   # snap
rm ~/.local/bin/nerd-fonts-installer    # tarball

Fonts it installed are just files. Remove the directory you set as destination and refresh the cache:

rm -rf ~/.local/share/fonts/NerdFonts
fc-cache -f

---

Next: ⚙️ Configuration · 🖱️ Interactive Picker