Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/getnf/getnf

A better way to install Nerd Fonts
https://github.com/getnf/getnf

Last synced: about 2 months ago
JSON representation

A better way to install Nerd Fonts

Awesome Lists containing this project

README

        

![getnf-logo](https://github.com/getnf/getnf/assets/9327361/60822070-8e14-43ae-882c-f36d36b6e4f0)

# `getnf` - Get Nerd Fonts

[![getnf](https://img.shields.io/github/last-commit/getnf/getnf?style=flat-square)](https://github.com/getnf/getnf/pulse)
[![getnf](https://img.shields.io/github/issues/getnf/getnf?style=flat-square)](https://github.com/getnf/getnf/issues)
[![getnf](https://img.shields.io/github/license/getnf/getnf?style=flat-square)](https://github.com/getnf/getnf/blob/master/LICENSE)
[![getnf](https://img.shields.io/github/stars/getnf/getnf?style=flat-square)](https://github.com/getnf/getnf/stargazers)

Easily install [Nerd Fonts](https://www.nerdfonts.com/) from the terminal.

![image](https://github.com/getnf/getnf/assets/84108846/55e535ea-73af-417f-b65d-7c095d58bdf0)

## Supported Platforms
`getnf` is supported on macOS and Linux.

## Prerequisites

- curl
- fontconfig *(only on Linux)*

## Installation
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 the [latest release](https://github.com/getnf/getnf/releases/latest) with
```
curl -fsSL https://raw.githubusercontent.com/getnf/getnf/main/install.sh | bash -s -- --branch=release-0.1
```

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

On Arch Linux you can install `getnf` from the [AUR](https://aur.archlinux.org/packages/getnf):
```
paru -S getnf
```

## 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 Nerd Fonts |
| `-i ` | Directly install a specified Nerd Font |
| `-i ,`,
`-i " "` | Directly install multiple Nerd Fonts |
| `-u ` | Uninstall a specified Nerd Font |
| `-u ,`,
`-u " "` | 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!