Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/getnf/getnf
A better way to install Nerd Fonts
https://github.com/getnf/getnf
Last synced: 5 days ago
JSON representation
A better way to install Nerd Fonts
- Host: GitHub
- URL: https://github.com/getnf/getnf
- Owner: getnf
- License: gpl-3.0
- Created: 2020-08-05T11:12:59.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-04T18:02:30.000Z (6 months ago)
- Last Synced: 2024-08-01T19:57:26.695Z (3 months ago)
- Language: Shell
- Size: 154 KB
- Stars: 855
- Watchers: 6
- Forks: 35
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome - getnf/getnf - A better way to install Nerd Fonts (Shell)
- awesome-linux-ricing - getnf - A helpful tool to install Nerd Fonts. (Font / Nerd Fonts)
README
# `getnf` - Get Nerd Fonts
[](https://github.com/getnf/getnf/pulse)
[](https://github.com/getnf/getnf/issues)
[](https://github.com/getnf/getnf/blob/master/LICENSE)
[](https://github.com/getnf/getnf/stargazers)
Easily install [Nerd Fonts](https://www.nerdfonts.com/) from the terminal.
## Supported Platforms
`getnf` is supported on macOS and Linux.
## Requirements
- curl
- fzf *(optional)*
## 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 -- --tag=v0.1.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
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 |
| `-f` | Select and install Nerd Fonts using [fzf](https://github.com/junegunn/fzf) |
| `-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!
## Notes
In case you can't see newly installed fonts in your application, you may need to update the font cache with
```
fc-cache
```