2015-08-11 00:33:21 +02:00
< h1 align = "center" >
2019-11-23 06:56:50 +02:00
< img src = "images/nerd-fonts-logo.svg" alt = "Nerd Fonts Logo" / >
2015-08-11 00:33:21 +02:00
< / h1 >
2018-02-18 00:41:38 +02:00
< h2 align = "center" >
2018-04-08 14:23:08 +02:00
< img alt = "Iconic font aggregator, collection, and patcher" src = "images/project-subtitle-phrase.svg" >
2018-02-18 00:41:38 +02:00
< / h2 >
2015-11-11 17:23:50 +02:00
2018-03-17 04:21:44 +02:00
< div align = "center" >
2018-03-17 01:34:39 +02:00
2018-04-27 03:06:21 +02:00
[Releases][release] | [Fonts](#patched-fonts) | [Font Patcher](#font-patcher) | [Wiki Documentation][wiki] | [Stickers][stickers] | [VimDevIcons][vim-devicons]
2018-04-08 04:48:23 +02:00
2023-05-03 10:02:01 +02:00
[![GitHub release][img-version-badge]][repo] [![Gitter][img-gitter-badge]][gitter] [![Code of Conduct][coc-badge]][coc] [![PRs Welcome][prs-badge]][prs] < a href = "#patched-fonts" title = "" > < img src = "https://raw.githubusercontent.com/wiki/ryanoasis/nerd-fonts/images/faux-shield-badge-os-logos.svg?sanitize=true" alt = "Nerd Fonts - OS Support" > < / a >
2018-03-17 01:34:39 +02:00
2018-11-25 11:39:20 +02:00
2018-03-17 04:21:44 +02:00
< / div >
2016-11-18 06:46:22 +02:00
2016-11-18 05:44:34 +02:00
2021-12-22 15:47:28 +02:00
**Nerd Fonts** is a project that patches developer targeted fonts with a high number of glyphs (icons). Specifically to add a high number of extra glyphs from popular 'iconic fonts' such as [Font Awesome][font-awesome], [Devicons][vorillaz-devicons], [Octicons][octicons], and [others ](#glyph-sets ).
2016-03-15 15:03:39 +02:00
2016-05-15 20:03:03 +02:00
The following Sankey flow diagram shows the current glyph sets included:
2016-03-15 15:03:39 +02:00
2016-11-19 17:03:05 +02:00
< p align = "center" >
2018-03-03 21:04:32 +02:00
< img src = "images/sankey-glyphs-combined-diagram.svg" alt = "@SankeyMATIC Diagram" / >
2016-11-19 17:03:05 +02:00
< / p >
2017-04-01 12:52:17 +02:00
< sub > < i > Diagram created using < a href = "http://sankeymatic.com/" title = "SankeyMATIC (BETA): A Sankey diagram builder for everyone" > @SankeyMATIC< / a > < / i > < / sub >
2016-03-20 19:15:28 +02:00
2016-11-20 18:36:27 +02:00
## Important Notices
2016-11-23 02:13:37 +02:00
* `master` branch file paths are **not** considered stable. [Verify your repository URI references ](#unstable-file-paths )
2024-02-12 15:29:01 +02:00
* cloning this repository is **not** recommended ([due to Repo size](#option-7-clone-the-repo)) unless you are going to be [contributing to development ](#contributing )
2016-11-20 18:36:27 +02:00
2015-08-11 00:33:21 +02:00
## Table of Contents
2015-09-25 15:53:27 +02:00
2017-07-30 20:21:55 +02:00
[**TL;DR** ](#tldr )
2017-07-30 20:18:56 +02:00
2016-11-21 00:20:55 +02:00
[**Installation Options** ](#font-installation )
2024-02-12 15:29:01 +02:00
* [**1 - Release Archive Download** ](#option-1-release-archive-download )
* [**2 - Homebrew Fonts (macOS (OS X))** ](#option-2-homebrew-fonts )
* [**3 - Chocolatey or Scoop (Windows)** ](#option-3-unofficial-chocolatey-or-scoop-repositories )
* [**4 - Arch Linux Repository (Extra, AUR)** ](#option-4-arch-extra-repository )
* [**5 - Ad Hoc Curl Download** ](#option-5-ad-hoc-curl-download )
* [**6 - Install Script** ](#option-6-install-script )
* [**7 - Clone Repo** ](#option-7-clone-the-repo )
* [**8 - Patch Your Own Font** ](#option-8-patch-your-own-font )
2016-11-21 00:20:55 +02:00
2016-11-23 02:13:37 +02:00
[**Features** ](#features )
2016-11-21 00:20:55 +02:00
* [**Glyph/Icon sets** ](#glyph-sets )
* [**Patched Fonts** ](#patched-fonts )
2023-04-28 18:46:00 +02:00
* [**Variations** ](#variations )
2016-11-21 00:20:55 +02:00
* [**Font Patcher** ](#font-patcher )
2016-11-23 02:13:37 +02:00
[**Developer / Contributor** ](#font-patcher )
2016-11-21 00:20:55 +02:00
* [**Font Patcher** ](#font-patcher )
* [**Gotta Patch 'em All Font Patcher!** ](#gotta-patch-em-all )
* [**Other Good Fonts to Patch** ](#other-good-fonts-to-patch )
* [**Contributing** ](#contributing )
2016-11-20 18:54:09 +02:00
2017-08-23 18:03:43 +02:00
[**Project Motivation** ](#project-motivation )
2016-11-20 18:54:09 +02:00
2016-11-21 00:20:55 +02:00
**Additional Info**
* [**Unstable file paths on master** ](#unstable-file-paths )
* [**Changelog** ](#changelog )
* [**License** ](#license )
2016-11-20 18:54:09 +02:00
2015-08-11 00:33:21 +02:00
2017-07-30 20:18:56 +02:00
## TL;DR
Nerd Fonts takes popular programming fonts and adds a bunch of Glyphs.
There is also a [font patcher ](#font-patcher ) available if your desired font isn't already patched.
For more high level information see the [wiki][wiki]. If you are looking for the Vim plugin see [VimDevIcons ➶][vim-devicons].
### Various Download Options for Fonts
_If you..._
2024-02-12 15:29:01 +02:00
* `Option 1.` want to download a **font family** package of variations (bold, italic, etc.) see [download an archive ](#option-1-release-archive-download )
* `Option 2.` are on **macOS** and want to use **Homebrew** see [Homebrew Fonts ](#option-2-homebrew-fonts )
* `Option 3.` are on **Windows** and want to use **Chocolatey** or **Scoop** see [Unofficial Chocolatey or Scoop Repositories ](#option-3-unofficial-chocolatey-or-scoop-repositories )
* `Option 4.` are on **Arch Linux** and want to use **Extra packages** see [Arch Extra Repositories ](#option-4-arch-extra-repository )
* `Option 5.` want to use the ** `curl` command** or use in **scripts** see [Ad Hoc Curl Download ](#option-5-ad-hoc-curl-download )
* `Option 6.` want to **automate** installing or use in **scripts** see the [Install Script ](#option-6-install-script )
* `Option 7.` want **complete control** then see [cloning the repo ](#option-7-clone-the-repo )
* `Option 8.` want to patch your own font see the [Font Patcher ](#option-8-patch-your-own-font )
2017-07-30 20:18:56 +02:00
2016-11-23 02:13:37 +02:00
## Features
2017-08-10 03:01:02 +02:00
* A [FontForge Python script ](#font-patcher ) to patch any font
2017-07-15 23:05:39 +02:00
* Includes an option to create **Monospaced (fixed-pitch, fixed-width)** _or_ **double-width (non-monospaced)** glyphs
* For more details see the [**Font Patcher** ](#font-patcher ) section
2023-06-01 12:35:21 +02:00
* **`54`** already [patched font families ](#patched-fonts )
2022-01-27 16:30:48 +02:00
* Over ** `9,000` ** glyphs/icons combined [(more details) ](#combinations )
2022-09-13 07:06:41 +02:00
* Current glyph sets include: [Powerline with Extra Symbols][ryanoasis-powerline-extra-symbols], [Font Awesome][font-awesome], [Material Design Icons][font-material-design-icons], [Weather][font-weather], [Devicons][vorillaz-devicons], [Octicons][octicons], [Font Logos][font-logos] (Formerly Font Linux), [Pomicons][gabrielelana-pomicons], [Codeicons][codicons]
2023-04-28 18:46:00 +02:00
* **Monospaced (fixed-pitch, fixed-width)** _or_ **double-width (non-monospaced)** _or_ **proportional** glyphs version of each font
2017-07-15 23:05:39 +02:00
* This refers to the Nerd Font glyphs themselves not necessarily the Font as a whole
2016-11-23 02:13:37 +02:00
* A Developer/Contributor provided [bash script ](#gotta-patch-em-all ) to re-patch all the fonts
2015-08-11 00:33:21 +02:00
## Glyph Sets
2017-07-25 22:34:26 +02:00
:mag: :mag: You can now search for glyphs easily on [NerdFonts.com][Cheat Sheet] via the [Cheat Sheet][]
2017-04-27 02:01:47 +02:00
2019-08-02 05:56:40 +02:00
See [Wiki: Glyph Sets and Codepoints for more details][wiki-glyph-sets-codepoints]
2016-05-08 22:58:54 +02:00
2017-03-31 06:09:34 +02:00
### Icon names in shell
2019-08-09 06:25:30 +02:00
See [Wiki: Icon names in shell][wiki-icon-names-in-shell]
2017-04-22 14:26:44 +02:00
2014-12-05 06:29:54 +02:00
## Patched Fonts
2024-03-15 10:24:45 +02:00
A preview of all fonts can be found [here ](https://www.nerdfonts.com/font-downloads ).
| Font Name | Original Font Name and Repository | ver |\*RFN |
|:--------------------------------------------------|:---------------------------------------|:-----------|:-----|
| [0xProto Nerd Font][p-0xProto] | [0xProto][f-0xProto] | 1.602 | NO |
| [3270 Nerd Font][p-3270] | [3270][f-3270] | 3.0.1 | NO |
| [Agave Nerd Font][p-agave] | [Agave][f-agave] | 37 | NO |
| [AnonymicePro Nerd Font][p-anonymous-pro] | [Anonymous Pro][f-a-pro] | 1.002 | YES |
| [Arimo Nerd Font][p-arimo] | [Arimo][f-arimo] | 1.33 | NO |
| [AurulentSansMono Nerd Font][p-aurulent] | Aurulent Sans Mono (Stephen G. Hartke) | | NO |
| [BigBlueTerminal Nerd Font][p-bigblueterm] | BigBlueTerminal (VileR) | | NO |
| [BitstromWera Nerd Font][p-bitstream] | Vera Sans Mono (Bitstream Inc) | 1.1 | YES |
| [BlexMono Nerd Font][p-blex] | [IBM Plex Mono][f-ibm-plex] | 2.3 | YES |
| [CaskaydiaCove Nerd Font][p-cascadia] | [Cascadia Code][f-cascadia] | 2111.01 | YES |
| [CaskaydiaMono Nerd Font][p-cascadia-mono] | [Cascadia Mono][f-cascadia] | 2111.01 | YES |
| [CodeNewRoman Nerd Font][p-code-nr] | Code New Roman (Sam Radian) | 2.0 | NO |
| [ComicShannsMono Nerd Font][p-comic] | [Comic Shanns Mono][f-comic] | 1.3 | NO |
| [CommitMono Nerd Font][p-commit] | [Commit Mono][f-commit] | 1.141 | NO |
| [Cousine Nerd Font][p-cousine] | [Cousine][f-cousine] | 1.211 | NO |
| [D2Coding Nerd Font][p-d2coding] | [D2Coding][f-d2coding] | 1.3.2 | NO |
| [DaddyTimeMono Nerd Font][p-daddytimemono] | [DaddyTimeMono][f-daddytimemono] | 1.2.3 | NO |
| [DejaVuSansMono Nerd Font][p-dejavu] | [DejaVu][f-dejavu] | 2.37 | NO |
| [DroidSansMono Nerd Font][p-droid] | Droid Sans Mono (Ascender Corp) | 1.00-113 | NO |
| [EnvyCodeR Nerd Font][p-envy] | [Envy Code R][f-envy] | 0.79 | YES |
| [FantasqueSansMono Nerd Font][p-fantasque] | [Fantasque Sans Mono][f-fant] | 1.8.0 | NO |
| [FiraCode Nerd Font][p-fira-code] | [Fira Code][f-fira-code] | 6.2 | NO |
| [FiraMono Nerd Font][p-fira-mono] | [Fira Mono][f-fira-mono] | 3.206 | NO |
| [GeistMono Nerd Font][p-geist-mono] | [Geist Mono][f-geist-mono] | 1.0.1 | NO |
| [GoMono Nerd Font][p-go-mono] | [Go-Mono][f-go-mono] | 2.010 | NO |
| [Gohu Nerd Font][p-gohu] | [Gohu TTF][f-gohu2], [Gohu][f-gohu] | 2.0 | NO |
| [Hack Nerd Font][p-hack] | [Hack][f-hack] | 3.003 | NO |
| [Hasklug Nerd Font][p-hasklig] | [Hasklig][f-hasklig] | 1.2 | YES |
| [HeavyDataMono Nerd Font][p-heavy-data] | HeavyData (Vic Fieger) | 1 | NO |
| [Hurmit Nerd Font][p-hermit] | [Hermit][f-hermit] | 2.0 | YES |
| [iM-Writing Nerd Font][p-im-writing] | [iA-Writer][f-ia-writer] | Dec 2018 | YES |
| [Inconsolata Nerd Font][p-inconsolata] | [Inconsolata][f-inconsolata] | 3.000 | NO |
| [InconsolataGo Nerd Font][p-inconsolata-go] | [InconsolataGo][f-inconsolatago] | 1.013 | NO |
| [Inconsolata LGC Nerd Font][p-inconsolata-lgc] | [Inconsolata LGC][f-inconsolatalgc] | 1.3 | NO |
| [IntoneMono Nerd Font][p-intel-one-mono] | [Intel One Mono][f-intel-one-mono] | 1.2.1 | YES |
| [Iosevka Nerd Font][p-iosevka] | [Iosevka][f-iosevka] | 22.1.0 | NO |
| [IosevkaTerm Nerd Font][p-iosevka-term] | [Iosevka Term][f-iosevka] | 22.1.0 | NO |
| [IosevkaTermSlab Nerd Font][p-iosevka-term-slab] | [Iosevka Term Slab][f-iosevka] | 22.1.1 | NO |
| [JetBrainsMono Nerd Font][p-jetbrains-mono] | [JetBrains Mono][f-jetbrains-mono] | 2.304 | NO |
| [Lekton Nerd Font][p-lekton] | [Lekton][f-lekton] | 34 | NO |
| [Literation Nerd Font][p-liberation] | [Liberation][f-liberation] | 2.1.5 | YES |
| [Lilex Nerd Font][p-lilex] | [Lilex][f-lilex] | 2.300 | NO |
2024-03-15 11:16:42 +02:00
| [MartianMono Nerd Font][p-martian] | [MartianMono][f-martian] | 1.0.0 | NO |
2024-03-15 10:24:45 +02:00
| [Meslo Nerd Font][p-meslo] | [Meslo][f-meslo] | 1.21 | NO |
| [Monaspice Nerd Font][p-monaspace] | [Monaspace][f-monaspace] | 1.0.0 | YES |
| [Monofur Nerd Font][p-monofur] | Monofur (Tobias B Koehler) | 1.0 | NO |
| [Monoid Nerd Font][p-monoid] | [Monoid][f-monoid] | 0.61 | NO |
| [Mononoki Nerd Font][p-mononoki] | [Mononoki][f-mononoki] | 1.6 | YES |
| [MPlus Nerd Font][p-mplus] | [M+ Fonts][f-mplus] | 2023/03 | NO |
| [Noto Nerd Font][p-noto] | [Noto][f-noto] | div | NO |
| [OpenDyslexic Nerd Font][p-opendyslexic] | [OpenDyslexic][f-opendyslexic] | 2.001 | NO |
| [Overpass Nerd Font][p-overpass] | [Overpass][f-overpass] | 3.0.5 | NO |
| [ProFont Nerd Font][p-profont] | [ProFont][f-profont] | 2.3, 2.2 | NO |
| [ProggyClean Nerd Font][p-proggy-clean] | ProggyClean (Tristan Grimmer) | 2004/04/15 | NO |
| [RobotoMono Nerd Font][p-roboto] | [Roboto Mono][f-roboto] | 3.0 | NO |
| [SauceCodePro Nerd Font][p-source-code-pro] | [Source Code Pro][f-source] | 2.038 | YES |
| [ShureTechMono Nerd Font][p-share-tech-mono] | [Share Tech Mono][f-share] | 1.003 | YES |
| [SpaceMono Nerd Font][p-space-mono] | [Space Mono][f-space] | 1.001 | NO |
| [Terminess Nerd Font][p-terminus] | [Terminus TTF][f-terminus] | 4.49.2 | YES |
| [Tinos Nerd Font][p-tinos] | [Tinos][f-tinos] | 1.23 | NO |
| [Ubuntu Nerd Font][p-ubuntu] | [Ubuntu Font][f-ubuntu] | 0.83 | NO |
| [UbuntuMono Nerd Font][p-ubuntu-mono] | [Ubuntu Font][f-ubuntu] | 0.80 | NO |
| [VictorMono Nerd Font][p-victor] | [Victor Mono][f-victor] | 1.5.4 | NO |
< sub > _\*RFN = Reserved Font Name_</ sub >
2015-08-11 00:33:21 +02:00
2016-11-20 18:46:26 +02:00
### Variations
2017-04-22 14:49:29 +02:00
- no flags given (defaults to only **Seti-UI + Custom** and ** [Devicons][vorillaz-devicons]**)
2023-04-28 18:46:00 +02:00
- **double _(variable/proportional)_ ** or **single _(fixed/monospaced)_** or **proportional** width glyphs
2017-04-22 14:49:29 +02:00
- [Font Awesome][font-awesome]
- [Font Awesome Extension][font-awesome-extension]
2018-03-18 03:54:48 +02:00
- [Material Design Icons][font-material-design-icons]
- [Weather][font-weather]
2017-04-22 14:49:29 +02:00
- [GitHub Octicons][octicons]
2022-09-13 07:06:41 +02:00
- [Font Logos][font-logos] (Formerly Font Linux)
2017-04-22 14:49:29 +02:00
- [Powerline Extra Symbols][ryanoasis-powerline-extra-symbols]
- [IEC Power Symbols][website-iecpower]
- [Pomicons][gabrielelana-pomicons]
2021-12-22 15:47:28 +02:00
- [Codicons][codicons]
2015-08-11 00:33:21 +02:00
2015-11-23 01:50:15 +02:00
## Font Installation
2024-02-12 15:29:01 +02:00
### `Option 1: Release Archive Download`
2017-07-30 20:18:56 +02:00
> Best option if you want an **archive** or complete **font family** of variations (Bold, Italic, etc.).
Fonts are available for download as packages in the [latest release ](https://github.com/ryanoasis/nerd-fonts/releases/latest )
2024-02-12 15:29:01 +02:00
A nice overview is [on the Nerd Font site ](https://www.nerdfonts.com/font-downloads ) (but misses the more compact `xv` archives).
2017-07-30 20:18:56 +02:00
2023-06-25 13:42:21 +02:00
If you want download the latest release of a given font inside a script you can use (replace "JetBrainsMono" with your font):
```sh
curl -OL https://github.com/ryanoasis/nerd-fonts/releases/latest/download/JetBrainsMono.tar.xz
```
2024-02-12 15:29:01 +02:00
### `Option 2: Homebrew Fonts`
> Best option if on **macOS** and want to use **Homebrew**.
All fonts are available via [Homebrew Cask Fonts ](https://github.com/Homebrew/homebrew-cask-fonts ) on macOS (OS X)
```sh
brew tap homebrew/cask-fonts
brew install font-hack-nerd-font
```
### `Option 3: Unofficial Chocolatey or Scoop Repositories`
> Option for **Windows** and wanting to use **Chocolatey** or **Scoop**.
Chocolatey users can download fonts published to the [Chocolatey Community Repository (CCR) ](https://community.chocolatey.org/packages ):
```powershell
choco install nerd-fonts-hack
```
Scoop users can download fonts using the [Scoop bucket for Nerd Fonts ](https://github.com/matthewjberger/scoop-nerd-fonts ):
```powershell
scoop bucket add nerd-fonts
scoop install Hack-NF
```
### `Option 4: Arch Extra Repository`
> Option for **Arch Linux** and wanting to use **Extra packages**.
Most fonts are available via [Arch Extra packages ](https://archlinux.org/groups/any/nerd-fonts/ ).
Some special packages are [in AUR ](https://aur.archlinux.org/packages?K=nerd-fonts-&outdated=off ).
### `Option 5: Ad Hoc Curl Download`
> Option if you want to use the **`curl` command** or for use in **scripts**.
_Note_: Will not work to get newer fonts as they are not inside the repo anymore.
#### Linux
```sh
mkdir -p ~/.local/share/fonts
cd ~/.local/share/fonts & & curl -fLO https://github.com/ryanoasis/nerd-fonts/raw/HEAD/patched-fonts/DroidSansMono/DroidSansMNerdFont-Regular.otf
```
_Note:_ deprecated alternative paths: `~/.fonts`
#### macOS (OS X)
```sh
cd ~/Library/Fonts & & curl -fLO https://github.com/ryanoasis/nerd-fonts/raw/HEAD/patched-fonts/DroidSansMono/DroidSansMNerdFont-Regular.otf
```
### `Option 6: Install Script`
2016-11-21 00:20:55 +02:00
2017-07-30 20:00:00 +02:00
> Best option if you want to **automate** installing or for use in **scripts**.
2024-02-12 15:29:01 +02:00
_Note_: **Requires (shallow) cloning** the repo as of now :-(
_Note_: Will not work to get newer fonts as they are not inside the repo anymore.
2015-11-23 01:50:15 +02:00
2016-11-21 00:20:55 +02:00
#### All fonts:
* Installs all the patched Fonts (_Warning: This is a lot of Fonts adding up to a large size_)
```sh
./install.sh
```
2021-01-27 02:25:32 +02:00
or, in Powershell (Windows only):
```pwsh
./install.ps1
```
2016-11-21 00:20:55 +02:00
#### Single font:
* Installs a single Font of your choice
```sh
./install.sh < FontName >
./install.sh Hack
./install.sh HeavyData
```
2021-01-27 02:25:32 +02:00
or, in Powershell (Windows only):
```pwsh
./install.ps1 < FontName >
./install.ps1 Hack
./install.ps1 HeavyData
2022-09-24 12:00:55 +02:00
./install.ps1 FiraCode, Hack
./install.ps1 DejaVuSansMono -WhatIf
2021-01-27 02:25:32 +02:00
```
2024-02-12 15:29:01 +02:00
### `Option 7: Clone the Repo`
2017-07-30 20:18:56 +02:00
2021-05-13 11:20:03 +02:00
> Best option for **full control**, **all** or **some** of the fonts, or **contributing** to development.
2017-07-30 20:18:56 +02:00
2024-02-12 15:29:01 +02:00
_Note_: Will not work to get newer fonts as they are not inside the repo anymore.
2021-05-13 11:20:03 +02:00
A full clone of this repository is **not** required nor efficient (mostly due to Repository size) if you are simply only interested in a limited set of fonts.
2017-07-30 20:18:56 +02:00
2021-05-13 11:20:03 +02:00
If you do want to clone the entire repo be sure to _shallow_ clone:
2017-07-30 20:18:56 +02:00
```sh
git clone --depth 1
```
2024-02-12 15:08:14 +02:00
Even if you develop you probably do not need the old versions of the font files. With this command you have all commits but not all the old data - it will be loaded only if you check out old binaries (or do a blame):
```sh
git clone --filter=blob:none git@github.com:ryanoasis/nerd-fonts
```
If you want to clone just a sub-directory, use `git sparse-checkout` .
2021-05-13 11:20:03 +02:00
```sh
git clone --filter=blob:none --sparse git@github.com:ryanoasis/nerd-fonts
cd nerd-fonts
git sparse-checkout add patched-fonts/JetBrainsMono
```
2024-02-12 15:29:01 +02:00
### `Option 8: Patch Your Own Font`
2016-11-21 00:20:55 +02:00
2017-07-30 20:00:00 +02:00
> The option for **patching** your **own font** or fully **customizing** the patched font.
2017-08-10 03:01:02 +02:00
Use the provided Python command line script to generate a patched font from your own font to get the extra new glyphs
2016-11-21 00:20:55 +02:00
See: [Font Patcher ](#font-patcher ) for usage
* use this option if you do __not__ want to use one of the [fonts provided ](#patched-fonts )
2016-11-23 02:13:37 +02:00
* you will still need to copy the generated font to the correct font directory on your system
2016-05-09 10:44:55 +02:00
2023-10-13 13:54:30 +02:00
## font-patcher
2015-08-11 00:33:21 +02:00
2023-10-13 13:54:30 +02:00
< p align = "center" >
< img src = "images/nerd-fonts-patcher-logo.png" alt = "Nerd Fonts Patcher" >
< / p >
2015-08-11 00:33:21 +02:00
2023-02-04 12:47:38 +02:00
Patching the font of your own choosing:
* Use the script
* Download script and its helper files as [archive ](https://github.com/ryanoasis/nerd-fonts/releases/latest/download/FontPatcher.zip ) and extract
* Just downloading the `font-patcher` script is not enough.
* Requires: Fontforge, Python 3, `python-fontforge` and `argparse` packages
* Fontforge can be installed as package
* or on OSX via `brew install fontforge`
* or as [AppImage ](https://github.com/fontforge/fontforge/releases )
* Usage, recommended:
2021-05-11 23:53:40 +02:00
```
2023-02-04 12:47:38 +02:00
fontforge -script font-patcher PATH_TO_FONT
2021-05-11 23:53:40 +02:00
```
2023-02-04 12:47:38 +02:00
* Usage, direct (more convenient call, if it works for you):
2021-05-11 23:53:40 +02:00
```
2023-02-04 12:47:38 +02:00
./font-patcher PATH_TO_FONT
2021-05-11 23:53:40 +02:00
```
2023-02-04 12:47:38 +02:00
* Usage, with Fontforge AppImage
2021-05-11 23:53:40 +02:00
2023-02-04 12:47:38 +02:00
_Note_ : `chmod u+x` the AppImage after download. All supplied paths need to be **absolute** and an explicit output path is required! If everything is located in the same directory, you can use the `$PWD` shorthand.
2021-05-11 23:53:40 +02:00
```
./FontForge.AppImage -script $PWD/font-patcher $PWD/BaseFont.ttf -out /tmp
```
2020-03-07 13:51:41 +02:00
2023-02-04 12:47:38 +02:00
* Use docker
2024-02-04 23:53:56 +02:00
* Default parallel tasks
2021-05-11 23:53:40 +02:00
```
2023-09-16 20:02:10 +02:00
docker run --rm -v /path/to/fonts:/in:Z -v /path/for/output:/out:Z nerdfonts/patcher [OPTIONS]
2021-05-11 23:53:40 +02:00
```
2024-02-04 23:53:56 +02:00
* Single process (slow)
```
docker run --rm -v /path/to/fonts:/in:Z -v /path/for/output:/out:Z -e "PN=1" nerdfonts/patcher [OPTIONS]
```
* Specify the parallel tasks number to 10
```
docker run --rm -v /path/to/fonts:/in:Z -v /path/for/output:/out:Z -e "PN=10" nerdfonts/patcher [OPTIONS]
```
2021-05-11 23:53:40 +02:00
2023-09-29 23:25:29 +02:00
> [!NOTE]
2023-09-30 15:13:01 +02:00
> The resulting font's family (aka font name) will be set to the original family after CamelCasing, removing whitespace and appending ` Nerd Font`. For example, `iosevka term` would become `IosevkaTerm Nerd Font`.
2023-09-29 23:15:16 +02:00
2023-10-13 20:53:13 +02:00
Full options follow, see also [**page explaining all options** ](https://github.com/ryanoasis/nerd-fonts/wiki/ScriptOptions ):
2015-11-11 03:19:56 +02:00
2015-03-01 19:59:09 +02:00
```
2023-11-21 18:39:38 +02:00
Nerd Fonts Patcher v3.1.0-6 (4.8.1) (ff 20230101)
usage: font-patcher [-h] [-v] [-s] [--variable-width-glyphs]
[--debug [{0,1,2,3}]] [-q] [--careful] [-ext EXTENSION]
[-out OUTPUTDIR] [--makegroups [{-1,0,1,2,3,4,5,6}]] [-c]
[--codicons] [--fontawesome] [--fontawesomeext]
[--fontlogos] [--material] [--octicons] [--powersymbols]
[--pomicons] [--powerline] [--powerlineextra] [--weather]
[--boxdrawing] [--configfile CONFIGFILE] [--custom CUSTOM]
[--dry] [--glyphdir GLYPHDIR] [--has-no-italic] [-l]
[--metrics {HHEA,TYPO,WIN}] [--name FORCE_NAME]
[--postprocess POSTPROCESS] [--removeligs]
[--xavgcharwidth [XAVGWIDTH]]
[--progressbars | --no-progressbars]
2015-08-11 00:33:21 +02:00
font
2014-12-05 06:29:54 +02:00
2016-12-15 07:20:00 +02:00
Nerd Fonts Font Patcher: patches a given font with programming and development related glyphs
2017-07-31 00:00:51 +02:00
* Website: https://www.nerdfonts.com
2023-11-21 18:39:38 +02:00
* Version: 3.1.0-6
2017-07-31 00:00:51 +02:00
* Development Website: https://github.com/ryanoasis/nerd-fonts
2022-10-17 11:33:40 +02:00
* Changelog: https://github.com/ryanoasis/nerd-fonts/blob/-/changelog.md
2015-03-01 19:59:09 +02:00
positional arguments:
2016-10-23 23:23:00 +02:00
font The path to the font to patch (e.g., Inconsolata.otf)
2015-01-22 03:04:51 +02:00
2022-09-01 11:44:13 +02:00
options:
2015-03-01 19:59:09 +02:00
-h, --help show this help message and exit
2016-05-08 22:58:54 +02:00
-v, --version show program's version number and exit
2016-12-15 07:20:00 +02:00
-s, --mono, --use-single-width-glyphs
2023-11-21 18:39:38 +02:00
Whether to generate the glyphs as single-width not double-width (default is double-width) (Nerd Font Mono)
--variable-width-glyphs
Do not adjust advance width (no "overhang") (Nerd Font Propo)
--debug [{0,1,2,3}] Verbose mode (optional: 1=just to file; 2*=just to terminal; 3=display and file)
-q, --quiet Do not generate verbose output
2022-09-01 11:44:13 +02:00
--careful Do not overwrite existing glyphs if detected
2023-11-21 18:39:38 +02:00
-ext EXTENSION, --extension EXTENSION
2022-09-01 11:44:13 +02:00
Change font file type to create (e.g., ttf, otf)
2023-11-21 18:39:38 +02:00
-out OUTPUTDIR, --outputdir OUTPUTDIR
2022-09-01 11:44:13 +02:00
The directory to output the patched font file to
2023-06-05 11:54:13 +02:00
--makegroups [{-1,0,1,2,3,4,5,6}]
2023-11-21 18:39:38 +02:00
Use alternative method to name patched fonts (default=1)
2022-09-01 11:44:13 +02:00
Symbol Fonts:
2023-11-21 18:39:38 +02:00
-c, --complete Add all available Glyphs
--codicons Add Codicons Glyphs (https://github.com/microsoft/vscode-codicons)
2017-07-28 22:29:44 +02:00
--fontawesome Add Font Awesome Glyphs (http://fontawesome.io/)
2023-11-21 18:39:38 +02:00
--fontawesomeext Add Font Awesome Extension Glyphs (https://andrelzgava.github.io/font-awesome-extension/)
--fontlogos Add Font Logos Glyphs (https://github.com/Lukas-W/font-logos)
--material, --mdi Add Material Design Icons (https://github.com/templarian/MaterialDesign)
2016-05-08 22:58:54 +02:00
--octicons Add Octicons Glyphs (https://octicons.github.com)
2017-07-28 22:29:44 +02:00
--powersymbols Add IEC Power Symbols (https://unicodepowersymbol.com/)
2016-12-15 07:20:00 +02:00
--pomicons Add Pomicon Glyphs (https://github.com/gabrielelana/pomicons)
2015-11-16 01:50:11 +02:00
--powerline Add Powerline Glyphs
2023-11-21 18:39:38 +02:00
--powerlineextra Add Powerline Extra Glyphs (https://github.com/ryanoasis/powerline-extra-symbols)
--weather Add Weather Icons (https://github.com/erikflowers/weather-icons)
Expert Options:
--boxdrawing Force patching in (over existing) box drawing glyphs
--configfile CONFIGFILE
Specify a file path for JSON configuration file (see sample: src/config.sample.json)
--custom CUSTOM Specify a custom symbol font, all glyphs will be copied; absolute path suggested
--dry Do neither patch nor store the font, to check naming
--glyphdir GLYPHDIR Path to glyphs to be used for patching
--has-no-italic Font family does not have Italic (but Oblique), to help create correct RIBBI set
-l, --adjust-line-height
Whether to adjust line heights (attempt to center powerline separators more evenly)
--metrics {HHEA,TYPO,WIN}
Select vertical metrics source (for problematic cases)
--name FORCE_NAME Specify naming source ('full', 'postscript', 'filename', or concrete free name-string)
--postprocess POSTPROCESS
Specify a Script for Post Processing
--removeligs, --removeligatures
Removes ligatures specificed in JSON configuration file (needs --configfile)
--xavgcharwidth [XAVGWIDTH]
Adjust xAvgCharWidth (optional: concrete value)
--progressbars Show percentage completion progress bars per Glyph Set (default)
--no-progressbars Don't show percentage completion progress bars per Glyph Set
2015-03-01 19:59:09 +02:00
```
2015-11-26 17:08:46 +02:00
#### Examples
2015-03-01 19:59:09 +02:00
2021-05-11 23:53:40 +02:00
```
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf -s -q
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf --use-single-width-glyphs --quiet
./font-patcher Inconsolata.otf --fontawesome
./font-patcher Inconsolata.otf --fontawesome --octicons --pomicons
./font-patcher Inconsolata.otf
./FontForge.AppImage -script /tmp/nerdfonts/font-patcher /tmp/nerdfonts/CascadiaMonoPL-Semibold.ttf --fontawesome -out /tmp
./FontForge.AppImage -script $PWD/font-patcher $PWD/CascadiaMonoPL-Semibold.ttf --octicons -out $HOME
2023-09-16 22:47:38 +02:00
docker run --rm -v ~/myfont/patchme:/in:Z -v ~/myfont/patched:/out:Z nerdfonts/patcher
docker run --rm -v ~/Desktop/myfont/patchme:/in:Z -v ~/Desktop/myfont/patched:/out:Z nerdfonts/patcher --fontawesome
2021-05-11 23:53:40 +02:00
```
2014-12-05 06:29:54 +02:00
2023-04-28 18:46:00 +02:00
Usually you want the `--complete` option.
2015-08-11 00:33:21 +02:00
< a name = "gotta-patch-em-all" > < / a >
## Gotta Patch 'em All Font Patcher!
2016-10-22 17:40:41 +02:00
* for Contributor or Developer use
* re-patches **all** fonts in the unpatched directory:
2021-05-11 23:53:40 +02:00
```
./gotta-patch-em-all-font-patcher\!.sh
```
2016-10-22 17:40:41 +02:00
* can optionally limit to specific font name pattern:
2015-11-11 17:23:50 +02:00
2021-05-11 23:53:40 +02:00
```
./gotta-patch-em-all-font-patcher\!.sh Hermit
```
2016-11-23 02:13:37 +02:00
2023-02-04 12:47:38 +02:00
* or to specific directory name start:
```
./gotta-patch-em-all-font-patcher\!.sh /Heavy
```
2023-04-28 18:46:00 +02:00
Full options:
```
Usage: ./gotta-patch-em-all-font-patcher!.sh [OPTION] [FILTER]
OPTION:
-c, --checkfont Create the font(s) in check-fonts/ instead
-t, --keeptime Try to preserve timestamp of previously patched
font in patched-fonts/ directory
-v, --verbose Show more information when running
-i, --info Rebuild JUST the readmes
-j, --jobs Run up to 8 patch processes in parallel
-h, --help Show this help
FILTER:
The filter argument to this script is a filter for the fonts to patch.
The filter is a regex (glob * is expressed as [^/]* , see `man 7 glob` )
All font files that start with that filter (and are ttf, otf, or sfd files) will
be processed only.
Example ./gotta-patch-em-all-font-patcher\!.sh "iosevka"
Process all font files that start with "iosevka"
If the argument starts with a '/' all font files in a directory that matches
the filter are processed only.
Example ./gotta-patch-em-all-font-patcher\!.sh "/iosevka"
Process all font files that are in directory "iosevka"
```
2016-11-23 02:13:37 +02:00
## Contributing
See [contributing.md ](contributing.md )
2016-11-18 07:13:10 +02:00
## Unstable File Paths
2015-11-11 17:23:50 +02:00
2017-07-25 22:34:26 +02:00
:warning: Warning: File paths may change based on releases (especially **major** version bumps)
2017-04-01 15:00:58 +02:00
2018-04-29 17:45:39 +02:00
Reference the **release** branch and _not_ the ~~master~~ branch because paths are subject to change for each release
2017-04-01 15:00:58 +02:00
* For example:
2017-07-25 22:34:26 +02:00
* :white_check_mark: Use: < code > https\://github.com/ryanoasis/nerd-fonts/blob/< b > 0.9.0</ b > /patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf</ code >
* :x: Instead of: < code > https\://github.com/ryanoasis/nerd-fonts/blob/< del > master</ del > /patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf</ code >
2015-11-11 17:23:50 +02:00
2016-11-23 02:13:37 +02:00
2015-08-11 00:33:21 +02:00
## Other Good Fonts to Patch
2021-12-24 13:05:35 +02:00
Non exhaustive list of fonts that would benefit from being patched but are not included in Nerd Fonts due to their license (proprietary, commercial, etc.):
2021-05-11 23:53:40 +02:00
2021-12-24 13:05:35 +02:00
* [Input Mono][input-mono]
* [PragmataPro][pragmatapro]
* [Consolas][consolas]
* [Operator Mono][operator]
* [Dank Mono][dank]
2015-08-11 00:33:21 +02:00
2016-11-23 02:13:37 +02:00
2017-04-01 14:44:51 +02:00
## Project Motivation
2015-08-11 00:33:21 +02:00
2017-04-01 14:44:51 +02:00
See [Wiki: Project Purpose][wiki-project-purpose]
2015-08-11 00:33:21 +02:00
2016-05-15 20:03:03 +02:00
## Changelog
See [changelog.md ](changelog.md )
2014-12-05 06:29:54 +02:00
## License
2021-12-24 13:05:35 +02:00
See [LICENSE][LICENSE]
2015-08-11 00:33:21 +02:00
2016-05-08 22:58:54 +02:00
<!--
Repo References
-->
2017-04-01 13:52:25 +02:00
[vim-devicons]:https://github.com/ryanoasis/vim-devicons "VimDevIcons Vim Plugin (external link) ➶"
2017-07-28 22:29:44 +02:00
[vorillaz-devicons]:https://vorillaz.github.io/devicons/
2015-08-11 00:33:21 +02:00
[font-awesome]:https://github.com/FortAwesome/Font-Awesome
2017-07-17 10:29:06 +02:00
[font-awesome-extension]:https://github.com/AndreLZGava/font-awesome-extension
2018-03-18 03:54:48 +02:00
[font-material-design-icons]:https://github.com/Templarian/MaterialDesign
[font-weather]:https://github.com/erikflowers/weather-icons
2017-07-28 22:29:44 +02:00
[octicons]:https://github.com/primer/octicons
2022-09-13 07:06:41 +02:00
[font-logos]:https://github.com/Lukas-W/font-logos
2015-08-11 00:33:21 +02:00
[gabrielelana-pomicons]:https://github.com/gabrielelana/pomicons
[Seti-UI]:https://atom.io/themes/seti-ui
[ryanoasis-powerline-extra-symbols]:https://github.com/ryanoasis/powerline-extra-symbols
2021-12-22 15:47:28 +02:00
[codicons]:https://github.com/microsoft/vscode-codicons
2016-03-15 15:03:39 +02:00
[wiki]:https://github.com/ryanoasis/nerd-fonts/wiki
2017-04-01 14:44:51 +02:00
[wiki-project-purpose]:https://github.com/ryanoasis/nerd-fonts/wiki/Project-Purpose
2019-08-02 05:56:40 +02:00
[wiki-glyph-sets-codepoints]:https://github.com/ryanoasis/nerd-fonts/wiki/Glyph-Sets-and-Code-Points
2019-08-09 06:25:30 +02:00
[wiki-icon-names-in-shell]:https://github.com/ryanoasis/nerd-fonts/wiki/Icon-Names-in-Shell
2016-11-19 17:03:05 +02:00
[repo]:https://github.com/ryanoasis/nerd-fonts
[gitter]:https://gitter.im/ryanoasis/nerd-fonts
2017-05-03 02:58:49 +02:00
[code-climate]:https://codeclimate.com/github/ryanoasis/nerd-fonts
2018-03-16 12:27:09 +02:00
2015-10-15 04:21:16 +02:00
2016-10-30 00:47:36 +02:00
<!--
Website References
-->
2017-07-28 22:29:44 +02:00
[website-iecpower]:https://unicodepowersymbol.com/
2020-03-31 05:49:20 +02:00
[Cheat Sheet]:https://nerdfonts.com/cheat-sheet
2018-04-08 04:53:21 +02:00
[stickers]:https://www.redbubble.com/people/ryanoasis/works/30764810-nerd-fonts-iconic-font-aggregator
2016-10-30 00:47:36 +02:00
2016-05-08 22:58:54 +02:00
<!--
2015-10-15 04:21:16 +02:00
Link References
-->
2017-07-28 22:29:44 +02:00
[badge-version]:https://badge.fury.io/gh/ryanoasis%2Fnerd-fonts
2015-10-15 04:21:16 +02:00
[badge-gitter]:https://gitter.im/ryanoasis/nerd-fonts?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge
2018-02-17 03:17:17 +02:00
[img-version-badge]:https://img.shields.io/github/release/ryanoasis/nerd-fonts.svg?style=for-the-badge
2018-01-25 04:29:13 +02:00
[img-gitter-badge]:https://img.shields.io/gitter/room/nwjs/nw.js.svg?style=for-the-badge
2019-02-17 04:23:10 +02:00
[img-code-climate-badge]:https://img.shields.io/codeclimate/issues/ryanoasis/nerd-fonts.svg?style=for-the-badge
2018-01-25 04:29:13 +02:00
[coc-badge]: https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=for-the-badge
2018-03-16 12:47:35 +02:00
[prs-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge& logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48c3ZnIGlkPSJzdmcyIiB3aWR0aD0iNjQ1IiBoZWlnaHQ9IjU4NSIgdmVyc2lvbj0iMS4wIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPiA8ZyBpZD0ibGF5ZXIxIj4gIDxwYXRoIGlkPSJwYXRoMjQxNyIgZD0ibTI5Ny4zIDU1MC44N2MtMTMuNzc1LTE1LjQzNi00OC4xNzEtNDUuNTMtNzYuNDM1LTY2Ljg3NC04My43NDQtNjMuMjQyLTk1LjE0Mi03Mi4zOTQtMTI5LjE0LTEwMy43LTYyLjY4NS01Ny43Mi04OS4zMDYtMTE1LjcxLTg5LjIxNC0xOTQuMzQgMC4wNDQ1MTItMzguMzg0IDIuNjYwOC01My4xNzIgMTMuNDEtNzUuNzk3IDE4LjIzNy0zOC4zODYgNDUuMS02Ni45MDkgNzkuNDQ1LTg0LjM1NSAyNC4zMjUtMTIuMzU2IDM2LjMyMy0xNy44NDUgNzYuOTQ0LTE4LjA3IDQyLjQ5My0wLjIzNDgzIDUxLjQzOSA0LjcxOTcgNzYuNDM1IDE4LjQ1MiAzMC40MjUgMTYuNzE0IDYxLjc0IDUyLjQzNiA2OC4yMTMgNzcuODExbDMuOTk4MSAxNS42NzIgOS44NTk2LTIxLjU4NWM1NS43MTYtMTIxLjk3IDIzMy42LTEyMC4xNSAyOTUuNSAzLjAzMTYgMTkuNjM4IDM5LjA3NiAyMS43OTQgMTIyLjUxIDQuMzgwMSAxNjkuNTEtMjIuNzE1IDYxLjMwOS02NS4zOCAxMDguMDUtMTY0LjAxIDE3OS42OC02NC42ODEgNDYuOTc0LTEzNy44OCAxMTguMDUtMTQyLjk4IDEyOC4wMy01LjkxNTUgMTEuNTg4LTAuMjgyMTYgMS44MTU5LTI2LjQwOC0yNy40NjF6IiBmaWxsPSIjZGQ1MDRmIi8%2BIDwvZz48L3N2Zz4%3D
2018-03-17 01:34:39 +02:00
[os-badge]:https://img.shields.io/badge/-OS-brightgreen.svg?style=for-the-badge& logoWidth=80& logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48c3ZnIHdpZHRoPSIzOS43NDFtbSIgaGVpZ2h0PSIxMy4zNzdtbSIgdmVyc2lvbj0iMS4xIiB2aWV3Qm94PSIwIDAgMzkuNzQxMjggMTMuMzc3MTI3IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOmNjPSJodHRwOi8vY3JlYXRpdmVjb21tb25zLm9yZy9ucyMiIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj48bWV0YWRhdGE%2BPHJkZjpSREY%2BPGNjOldvcmsgcmRmOmFib3V0PSIiPjxkYzpmb3JtYXQ%2BaW1hZ2Uvc3ZnK3htbDwvZGM6Zm9ybWF0PjxkYzp0eXBlIHJkZjpyZXNvdXJjZT0iaHR0cDovL3B1cmwub3JnL2RjL2RjbWl0eXBlL1N0aWxsSW1hZ2UiLz48ZGM6dGl0bGUvPjwvY2M6V29yaz48L3JkZjpSREY%2BPC9tZXRhZGF0YT48ZyB0cmFuc2Zvcm09Im1hdHJpeCguMzMwODMgMCAwIC4zMzA4MyAyNi41MDggLTEuNzc0MikiPjxwb2x5Z29uIHBvaW50cz0iMTcuNCAzOC4zIDIxLjUgNDAuNiAyNy43IDQwLjYgMzMuNSAzNi4yIDM2LjEgMjkuMyAzMC4xIDIyIDI4LjQgMTcuOSAyMC4xIDE4LjIgMjAuMiAyMC41IDE4LjYgMjMuNSAxNi4xIDI4LjQgMTUuNiAzMi41IiBmaWxsPSIjZWNlZmYxIi8%2BPHBhdGggZD0ibTM0LjMgMjMuOWMtMS42LTIuMy0yLjktMy43LTMuNi02LjZzMC4yLTIuMS0wLjQtNC42Yy0wLjMtMS4zLTAuOC0yLjItMS4zLTIuOS0wLjYtMC43LTEuMy0xLjEtMS43LTEuMi0wLjktMC41LTMtMS4zLTUuNiAwLjEtMi43IDEuNC0yLjQgNC40LTEuOSAxMC41IDAgMC40LTAuMSAwLjktMC4zIDEuMy0wLjQgMC45LTEuMSAxLjctMS43IDIuNC0wLjcgMS0xLjQgMi0xLjkgMy4xLTEuMiAyLjMtMi4zIDUuMi0yIDYuMyAwLjUtMC4xIDYuOCA5LjUgNi44IDkuNyAwLjQtMC4xIDIuMS0wLjEgMy42LTAuMSAyLjEtMC4xIDMuMy0wLjIgNSAwLjIgMC0wLjMtMC4xLTAuNi0wLjEtMC45IDAtMC42IDAuMS0xLjEgMC4yLTEuOCAwLjEtMC41IDAuMi0xIDAuMy0xLjYtMSAwLjktMi44IDEuOS00LjUgMi4yLTEuNSAwLjMtNC0wLjItNS4yLTEuNyAwLjEgMCAwLjMgMCAwLjQtMC4xIDAuMy0wLjEgMC42LTAuMiAwLjctMC40IDAuMy0wLjUgMC4xLTEtMC4xLTEuM3MtMS43LTEuNC0yLjQtMi0xLjEtMC45LTEuNS0xLjNsLTAuOC0wLjhjLTAuMi0wLjItMC4zLTAuNC0wLjQtMC41LTAuMi0wLjUtMC4zLTEuMS0wLjItMS45IDAuMS0xLjEgMC41LTIgMS0zIDAuMi0wLjQgMC43LTEuMiAwLjctMS4ycy0xLjcgNC4yLTAuOCA1LjVjMCAwIDAuMS0xLjMgMC41LTIuNiAwLjMtMC45IDAuOC0yLjIgMS40LTIuOXMyLjEtMy4zIDIuMi00LjljMC0wLjcgMC4xLTEuNCAwLjEtMS45LTAuNC0wLjQgNi42LTEuNCA3LTAuMyAwLjEgMC40IDEuNSA0IDIuMyA1LjkgMC40IDAuOSAwLjkgMS43IDEuMiAyLjcgMC4zIDEuMSAwLjUgMi42IDAuNSA0LjEgMCAwLjMgMCAwLjgtMC4xIDEuMyAwLjIgMCA0LjEtNC4yLTAuNS03LjcgMCAwIDIuOCAxLjMgMi45IDMuOSAwLjEgMi4xLTAuOCAzLjgtMSA0LjEgMC4xIDAgMi4xIDAuOSAyLjIgMC45IDAuNCAwIDEuMi0wLjMgMS4yLTAuMyAwLjEtMC4zIDAuNC0xLjEgMC40LTEuNCAwLjctMi4zLTEtNi0yLjYtOC4zeiIgZmlsbD0iIzI2MzIzOCIvPjxnIGZpbGw9IiNlY2VmZjEiPjxlbGxpcHNlIGN4PSIyMS42IiBjeT0iMTUuMyIgcng9IjEuMyIgcnk9IjIiLz48ZWxsaXBzZSBjeD0iMjYuMSIgY3k9IjE1LjIiIHJ4PSIxLjciIHJ5PSIyLjMiLz48L2c%2BPGcgZmlsbD0iIzIxMjEyMSI%2BPGVsbGlwc2UgdHJhbnNmb3JtPSJtYXRyaXgoLS4xMjU0IC0uOTkyMSAuOTkyMSAtLjEyNTQgOC45NzU0IDM4Ljk5NykiIGN4PSIyMS43IiBjeT0iMTUuNSIgcng9IjEuMiIgcnk9Ii43Ii8%2BPGVsbGlwc2UgY3g9IjI2IiBjeT0iMTUuNiIgcng9IjEiIHJ5PSIxLjMiLz48L2c%2BPGcgZmlsbD0iI2ZmYzEwNyI%2BPHBhdGggZD0ibTM5LjMgMzcuNmMtMC40LTAuMi0xLjEtMC41LTEuNy0xLjQtMC4zLTAuNS0wLjItMS45LTAuNy0yLjUtMC4zLTAuNC0wLjctMC4yLTAuOC0wLjItMC45IDAuMi0zIDEuNi00LjQgMC0wLjItMC4yLTAuNS0wLjUtMS0wLjVzLTAuNyAwLjItMC45IDAuNi0wLjIgMC43LTAuMiAxLjdjMCAwLjggMCAxLjctMC4xIDIuNC0wLjIgMS43LTAuNSAyLjctMC41IDMuNyAwIDEuMSAwLjMgMS44IDAuNyAyLjEgMC4zIDAuMyAwLjggMC41IDEuOSAwLjVzMS44LTAuNCAyLjUtMS4xYzAuNS0wLjUgMC45LTAuNyAyLjMtMS43IDEuMS0wLjcgMi44LTEuNiAzLjEtMS45IDAuMi0wLjIgMC41LTAuMyAwLjUtMC45IDAtMC41LTAuNC0wLjctMC43LTAuOHoiLz48cGF0aCBkPSJtMTkuMiAzNy45Yy0xLTEuNi0xLjEtMS45LTEuOC0yLjktMC42LTEtMS45LTIuOS0yLjctMi45LTAuNiAwLTAuOSAwLjMtMS4zIDAuN3MtMC44IDEuMy0xLjUgMS44Yy0wLjYgMC41LTIuMyAwLjQtMi43IDFzMC40IDEuNSAwLjQgM2MwIDAuNi0wLjUgMS0wLjYgMS40LTAuMSAwLjUtMC4yIDAuOCAwIDEuMiAwLjQgMC42IDAuOSAwLjggNC4zIDEuNSAxLjggMC40IDMuNSAxLjQgNC42IDEuNXMzIDAgMy0yLjdjMC4xLTEuNi0wLjgtMi0xLjctMy42eiIvPjxwYXRoIGQ9Im0yMS4xIDE5LjhjLTAuNi0wLjQtMS4xLTAuOC0xLjEtMS40czAuNC0wLjggMS0xLjNjMC4xLTAuMSAxLjItMS4xIDIuMy0xLjFzMi40IDAuNyAyLjkgMC45YzAuOSAwLjIgMS44IDAuNCAxLjcgMS4xLTAuMSAxLTAuMiAxLjItMS4yIDEuNy0wLjcgMC4yLTIgMS4zLTIuOSAxLjMtMC40IDAtMSAwLTEuNC0wLjEtMC4zLTAuMS0wLjgtMC42LTEuMy0xLjF6Ii8%2BPC9nPjxnIGZpbGw9IiM2MzQ3MDMiPjxwYXRoIGQ9Im0yMC45IDE5YzAuMiAwLjIgMC41IDAuNCAwLjggMC41IDAuMiAwLjEgMC41IDAuMiAwLjUgMC4yaDAuOWMwLjUgMCAxLjI
2018-03-16 12:27:09 +02:00
2016-03-20 21:56:48 +02:00
2021-05-11 23:53:40 +02:00
[consolas]:https://docs.microsoft.com/en-us/typography/font-list/consolas
2021-10-31 11:21:19 +02:00
[input-mono]:http://input.djr.com/download/
2017-07-28 22:29:44 +02:00
[pragmatapro]:https://www.fsd.it/shop/fonts/pragmatapro/
2018-04-29 17:45:39 +02:00
[operator]:https://www.typography.com/fonts/operator/
[dank]:https://dank.sh/
2016-10-23 23:23:00 +02:00
2017-04-01 13:52:25 +02:00
[release]:https://github.com/ryanoasis/nerd-fonts/releases/latest "Latest Release (external link) ➶"
2022-10-17 11:33:40 +02:00
[coc]:https://github.com/ryanoasis/nerd-fonts/blob/-/code_of_conduct.md "Contributor Covenant Code of Conduct"
[LICENSE]:https://github.com/ryanoasis/nerd-fonts/blob/-/LICENSE
2017-05-03 03:51:08 +02:00
[prs]:http://makeapullrequest.com "Make a Pull Request (external link) ➶"
2016-12-23 19:21:36 +02:00
2016-03-20 21:56:48 +02:00
<!--
Font repos
-->
2016-05-08 22:58:54 +02:00
2023-10-14 08:16:06 +02:00
[f-0xProto]:https://github.com/0xType/0xProto
2016-10-22 16:53:46 +02:00
[f-3270]:https://github.com/rbanffy/3270font
2022-10-17 11:25:26 +02:00
[f-agave]:https://github.com/agarick/agave
[f-a-pro]:https://www.marksimonson.com/fonts/view/anonymous-pro
[f-arimo]:https://github.com/googlefonts/Arimo
2020-01-27 07:55:13 +02:00
[f-cascadia]:https://github.com/microsoft/cascadia-code
2017-11-02 01:09:39 +02:00
[f-cousine]:https://fonts.google.com/specimen/Cousine
2023-04-30 10:13:52 +02:00
[f-comic]:https://github.com/jesusmgg/comic-shanns-mono
2023-11-13 17:30:25 +02:00
[f-commit]:https://github.com/eigilnikolajsen/commit-mono
2023-11-13 17:21:11 +02:00
[f-d2coding]:https://github.com/naver/d2codingfont
2022-10-17 11:25:26 +02:00
[f-daddytimemono]:https://github.com/BourgeoisBear/DaddyTimeMono
2022-10-18 16:08:32 +02:00
[f-dejavu]:https://github.com/dejavu-fonts/dejavu-fonts
2023-07-15 11:34:02 +02:00
[f-envy]:https://github.com/damieng/envy-code-r
2022-10-17 11:25:26 +02:00
[f-fant]:https://github.com/belluzj/fantasque-sans
2016-05-08 21:15:43 +02:00
[f-fira-code]:https://github.com/tonsky/FiraCode
2022-10-17 11:25:26 +02:00
[f-fira-mono]:https://github.com/mozilla/Fira
2023-10-28 11:32:31 +02:00
[f-geist-mono]:https://github.com/vercel/geist-font
2022-10-17 11:25:26 +02:00
[f-gohu2]:https://github.com/koemaeda/gohufont-ttf
[f-gohu]:http://font.gohu.org/
[f-go-mono]:https://go.googlesource.com/image/+/master/font/gofont/ttfs/
[f-hack]:https://github.com/chrissimpkins/Hack
[f-hasklig]:https://github.com/i-tu/Hasklig
2022-10-18 16:08:32 +02:00
[f-hermit]:https://pcaro.es/hermit
2022-10-17 11:25:26 +02:00
[f-ia-writer]:https://github.com/iaolo/iA-Fonts
[f-ibm-plex]:https://github.com/IBM/plex
[f-inconsolata]:https://github.com/googlefonts/Inconsolata
2022-10-18 16:08:32 +02:00
[f-inconsolatago]:https://levien.com/type/myfonts/inconsolata.html
[f-inconsolatalgc]:https://github.com/MihailJP/Inconsolata-LGC
2023-06-01 12:35:21 +02:00
[f-intel-one-mono]:https://github.com/intel/intel-one-mono
2016-05-08 21:15:43 +02:00
[f-iosevka]:https://github.com/be5invis/Iosevka
2020-01-16 12:19:43 +02:00
[f-jetbrains-mono]:https://github.com/JetBrains/JetBrainsMono
2022-10-18 16:08:32 +02:00
[f-lekton]:https://fonts.google.com/specimen/Lekton
2022-10-17 11:25:26 +02:00
[f-liberation]:https://github.com/liberationfonts/liberation-fonts
[f-lilex]:https://github.com/mishamyrt/Lilex
2024-03-15 11:16:42 +02:00
[f-martian]:https://github.com/evilmartians/mono
2022-10-18 16:08:32 +02:00
[f-meslo]:https://github.com/andreberg/Meslo-Font
2023-11-10 11:35:24 +02:00
[f-monaspace]:https://github.com/githubnext/monaspace
2022-10-17 11:25:26 +02:00
[f-monoid]:https://github.com/larsenwork/monoid
2022-10-18 16:08:32 +02:00
[f-mononoki]:https://madmalik.github.io/mononoki
[f-mplus]:https://mplusfonts.github.io
[f-noto]:https://fonts.google.com/noto
[f-opendyslexic]:https://github.com/antijingoist/open-dyslexic
[f-overpass]:http://overpassfont.org
[f-profont]:https://tobiasjung.name/profont
[f-roboto]:https://fonts.google.com/specimen/Roboto+Mono
2016-10-22 21:30:28 +02:00
[f-share]:https://fonts.google.com/specimen/Share+Tech+Mono
2022-10-17 11:25:26 +02:00
[f-source]:https://github.com/adobe-fonts/source-code-pro
2016-10-22 21:30:28 +02:00
[f-space]:https://fonts.google.com/specimen/Space+Mono
2022-10-17 11:25:26 +02:00
[f-terminus]:http://terminus-font.sourceforge.net
2022-10-18 16:08:32 +02:00
[f-tinos]:https://fonts.google.com/specimen/Tinos
[f-ubuntu]:http://font.ubuntu.com
2019-07-27 23:37:06 +02:00
[f-victor]:https://github.com/rubjo/victor-mono
2016-03-20 21:56:48 +02:00
2016-05-08 21:15:43 +02:00
<!--
Patched Font internal links
-->
2016-05-08 22:58:54 +02:00
2023-10-14 08:16:06 +02:00
[p-0xProto]:patched-fonts/0xProto
2016-05-08 21:15:43 +02:00
[p-3270]:patched-fonts/3270
2022-10-17 11:25:26 +02:00
[p-agave]:patched-fonts/Agave
2016-05-08 23:09:12 +02:00
[p-anonymous-pro]:patched-fonts/AnonymousPro
2017-10-20 03:23:00 +02:00
[p-arimo]:patched-fonts/Arimo
2022-10-17 11:25:26 +02:00
[p-aurulent]:patched-fonts/AurulentSansMono
2018-03-18 03:31:08 +02:00
[p-bigblueterm]:patched-fonts/BigBlueTerminal
2016-05-08 21:15:43 +02:00
[p-bitstream]:patched-fonts/BitstreamVeraSansMono
2019-08-24 22:58:27 +02:00
[p-blex]:patched-fonts/IBMPlexMono
2020-01-27 07:55:13 +02:00
[p-cascadia]:patched-fonts/CascadiaCode
2024-03-15 10:24:45 +02:00
[p-cascadia-mono]:patched-fonts/CascadiaMono
2022-10-17 11:25:26 +02:00
[p-code-nr]:patched-fonts/CodeNewRoman
2023-04-30 10:13:52 +02:00
[p-comic]:patched-fonts/ComicShannsMono
2023-11-13 17:30:25 +02:00
[p-commit]:patched-fonts/CommitMono
2017-11-02 01:09:39 +02:00
[p-cousine]:patched-fonts/Cousine
2023-11-13 17:21:11 +02:00
[p-d2coding]:patched-fonts/D2Coding
2022-10-17 11:25:26 +02:00
[p-daddytimemono]:patched-fonts/DaddyTimeMono
2016-05-08 21:15:43 +02:00
[p-dejavu]:patched-fonts/DejaVuSansMono
[p-droid]:patched-fonts/DroidSansMono
2023-07-15 11:34:02 +02:00
[p-envy]:patched-fonts/EnvyCodeR
2016-05-08 21:31:21 +02:00
[p-fantasque]:patched-fonts/FantasqueSansMono
2016-05-08 21:15:43 +02:00
[p-fira-code]:patched-fonts/FiraCode
[p-fira-mono]:patched-fonts/FiraMono
2023-10-28 11:32:31 +02:00
[p-geist-mono]:patched-fonts/GeistMono
2022-10-17 11:25:26 +02:00
[p-gohu]:patched-fonts/Gohu
[p-go-mono]:patched-fonts/Go-Mono
[p-hack]:patched-fonts/Hack
[p-hasklig]:patched-fonts/Hasklig
2016-05-08 21:15:43 +02:00
[p-heavy-data]:patched-fonts/HeavyData
[p-hermit]:patched-fonts/Hermit
2022-10-17 11:25:26 +02:00
[p-im-writing]:patched-fonts/iA-Writer
2017-02-12 09:34:37 +02:00
[p-inconsolata-go]:patched-fonts/InconsolataGo
2017-10-19 11:25:04 +02:00
[p-inconsolata-lgc]:patched-fonts/InconsolataLGC
2022-10-17 11:25:26 +02:00
[p-inconsolata]:patched-fonts/Inconsolata
2023-06-01 12:35:21 +02:00
[p-intel-one-mono]:patched-fonts/IntelOneMono
2016-05-08 21:15:43 +02:00
[p-iosevka]:patched-fonts/Iosevka
2023-04-01 17:01:36 +02:00
[p-iosevka-term]:patched-fonts/IosevkaTerm
2023-05-07 12:21:47 +02:00
[p-iosevka-term-slab]:patched-fonts/IosevkaTermSlab
2020-01-16 12:19:43 +02:00
[p-jetbrains-mono]:patched-fonts/JetBrainsMono
2016-05-08 21:15:43 +02:00
[p-lekton]:patched-fonts/Lekton
[p-liberation]:patched-fonts/LiberationMono
2020-04-28 19:03:33 +02:00
[p-lilex]:patched-fonts/Lilex
2024-03-15 11:16:42 +02:00
[p-martian]:patched-fonts/MartianMono
2016-05-08 21:15:43 +02:00
[p-meslo]:patched-fonts/Meslo
2024-01-01 15:54:27 +02:00
[p-monaspace]:patched-fonts/Monaspace
2016-05-08 21:15:43 +02:00
[p-monofur]:patched-fonts/Monofur
[p-monoid]:patched-fonts/Monoid
2022-10-17 11:25:26 +02:00
[p-mononoki]:patched-fonts/Mononoki
2016-05-08 21:15:43 +02:00
[p-mplus]:patched-fonts/MPlus
2018-04-21 05:01:26 +02:00
[p-noto]:patched-fonts/Noto
[p-opendyslexic]:patched-fonts/OpenDyslexic
[p-overpass]:patched-fonts/Overpass
2016-10-20 21:03:03 +02:00
[p-profont]:patched-fonts/ProFont
2016-05-08 21:15:43 +02:00
[p-proggy-clean]:patched-fonts/ProggyClean
[p-roboto]:patched-fonts/RobotoMono
2022-10-17 11:25:26 +02:00
[p-share-tech-mono]:patched-fonts/ShareTechMono
2016-05-08 21:15:43 +02:00
[p-source-code-pro]:patched-fonts/SourceCodePro
2022-10-17 11:25:26 +02:00
[p-space-mono]:patched-fonts/SpaceMono
2016-05-08 21:15:43 +02:00
[p-terminus]:patched-fonts/Terminus
2018-03-18 03:31:08 +02:00
[p-tinos]:patched-fonts/Tinos
2017-07-30 23:18:40 +02:00
[p-ubuntu-mono]:patched-fonts/UbuntuMono
2022-10-17 11:25:26 +02:00
[p-ubuntu]:patched-fonts/Ubuntu
2019-07-27 23:37:06 +02:00
[p-victor]:patched-fonts/VictorMono
2016-05-08 21:15:43 +02:00
2016-12-23 19:21:36 +02:00
<!--
Quick Link Images
-->
[ql-1]:images/nerd-fonts-character-logo-md.png "Latest Release (external link) ➶"
[ql-2]:images/nerd-fonts-character-logo-md.png "↓ View Patched Fonts List ↓"
[ql-3]:images/nerd-fonts-patcher-logo-md.png "↓ Font Patcher Details ↓"
[ql-4]:https://raw.githubusercontent.com/wiki/ryanoasis/vim-devicons/screenshots/v1.0.0/branding-logo-sm.png "VimDevIcons Vim Plugin (external link) ➶"
[ql-5]:images/nerd-fonts-character-logo-md.png "Font Package Archive (Zip) Downloads (external link) ➶"