Skip to content

getnf/getnf

Repository files navigation

getnf-logo

getnf - Get Nerd Fonts

getnf getnf getnf getnf getnf

Easily install Nerd Fonts from the terminal.

image

Supported Platforms

getnf is supported on macOS and Linux.

Requirements

  • curl
  • fzf (optional)

Install

Make sure that ~/.local/bin is in your PATH.

Run

curl -fsSL https://raw.githubusercontent.com/getnf/getnf/main/install.sh | bash

to install the latest version of getnf, or install a specific release with its tag, e.g. v0.3.0:

curl -fsSL https://raw.githubusercontent.com/getnf/getnf/main/install.sh | bash -s -- --tag=v0.3.0

You can suppress the installation output with the flag --silent or -s:

curl -fsSL https://raw.githubusercontent.com/getnf/getnf/main/install.sh | bash -s -- --silent

Packages

getnf is available in the AUR as getnf and getnf-git. Debian and RPM packages are also published with the latest release.

Usage

Run getnf to show the font menu.

There are several flags available:

Flag Description
-h Show the help message
-k Keep the downloaded font archives
-a Include installed Nerd Fonts in the menu
-g Install/Uninstall/List/Update Nerd Fonts for all users
-l List installed Nerd Fonts
-L List all available Nerd Fonts
-f Select and install Nerd Fonts using fzf
-i <font> Directly install a specified Nerd Font
-i <name1>,<name2>,
-i "<name1> <name2>"
Directly install multiple Nerd Fonts
-u <font> Uninstall a specified Nerd Font
-u <name1>,<name2>,
-u "<name1> <name2>"
Uninstall multiple Nerd Fonts
-U Update all installed Nerd Fonts
-V Print the current version of getnf

You can get the exact names of the fonts to use with -i and -u from getnf -L.

Enjoy!

Notes

In case you can't see newly installed fonts in your application, you may need to update the font cache with

fc-cache -f

Uninstall

To remove getnf without deleting the installed fonts, run

rm -rf ~/.local/bin/getnf ~/.local/share/getnf

You can also remove the font archive directory from your Downloads folder with

rm -rf "$(command -v xdg-user-dir >/dev/null && xdg-user-dir DOWNLOAD || printf '%s\n' "$HOME/Downloads")/getnf"