Releases   |   Fonts   |   Font Patcher   |   Wiki Documentation   |   Stickers   |   VimDevIcons

Important Notices

Table of Contents

TL;DR

Various Download Options for Fonts

Features

Glyph Sets

Icon names in shell

Patched Fonts

Variations

Font Installation

Option 1: Download and Install Manually

Option 2: Release Archive Download

curl -OL https://github.com/ryanoasis/nerd-fonts/releases/latest/download/JetBrainsMono.tar.xz

Option 3: Install Script

All fonts:

./install.sh

./install.ps1

Single font:

./install.sh<FontName>./install.sh Hack./install.sh HeavyData

./install.ps1<FontName>./install.ps1 Hack./install.ps1 HeavyData./install.ps1 FiraCode, Hack./install.ps1 DejaVuSansMono-WhatIf

Option 4: Homebrew Fonts

brew tap homebrew/cask-fontsbrew install font-hack-nerd-font

Option 5: Clone the Repo

git clone --depth 1

git clone --filter=blob:none --sparse git@github.com:ryanoasis/nerd-fontscd nerd-fontsgit sparse-checkout add patched-fonts/JetBrainsMono

Option 6: Ad Hoc Curl Download

Linux

mkdir -p~/.local/share/fontscd~/.local/share/fonts&& curl -fLO https://github.com/ryanoasis/nerd-fonts/raw/HEAD/patched-fonts/DroidSansMono/DroidSansMNerdFont-Regular.otf

macOS (OS X)

cd~/Library/Fonts&& curl -fLO https://github.com/ryanoasis/nerd-fonts/raw/HEAD/patched-fonts/DroidSansMono/DroidSansMNerdFont-Regular.otf

Option 7: Unofficial Chocolatey or Scoop Repositories

choco install nerd-fonts-hack

scoop bucket add nerd-fontsscoop install Hack-NF

Option 8: Arch Extra Repository

Option 9: Patch Your Own Font

font-patcher

Note

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 becomeIosevkaTerm Nerd Font.

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]                    fontNerd Fonts Font Patcher: patches a given font with programming and development related glyphs* Website: https://www.nerdfonts.com* Version: 3.1.0-6* Development Website: https://github.com/ryanoasis/nerd-fonts* Changelog: https://github.com/ryanoasis/nerd-fonts/blob/-/changelog.mdpositional arguments:  font                  The path to the font to patch (e.g., Inconsolata.otf)options:  -h, --help            show this help message and exit  -v, --version         show program's version number and exit  -s, --mono, --use-single-width-glyphs                        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  --careful             Do not overwrite existing glyphs if detected  -ext EXTENSION, --extension EXTENSION                        Change font file type to create (e.g., ttf, otf)  -out OUTPUTDIR, --outputdir OUTPUTDIR                        The directory to output the patched font file to  --makegroups [{-1,0,1,2,3,4,5,6}]                        Use alternative method to name patched fonts (default=1)Symbol Fonts:  -c, --complete        Add all available Glyphs  --codicons            Add Codicons Glyphs (https://github.com/microsoft/vscode-codicons)  --fontawesome         Add Font Awesome Glyphs (http://fontawesome.io/)  --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)  --octicons            Add Octicons Glyphs (https://octicons.github.com)  --powersymbols        Add IEC Power Symbols (https://unicodepowersymbol.com/)  --pomicons            Add Pomicon Glyphs (https://github.com/gabrielelana/pomicons)  --powerline           Add Powerline Glyphs  --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

Examples

./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 $HOMEdocker run --rm -v ~/myfont/patchme:/in:Z -v ~/myfont/patched:/out:Z nerdfonts/patcherdocker run --rm -v ~/Desktop/myfont/patchme:/in:Z -v ~/Desktop/myfont/patched:/out:Z nerdfonts/patcher --fontawesome

Gotta Patch 'em All Font Patcher!

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"

Contributing

Unstable File Paths

Other Good Fonts to Patch

Project Motivation

Changelog

License