ryanoasis / nerd-fonts

[Releases][release]   |   Fonts   |   Font Patcher   |   [Wiki Documentation][wiki]   |   [Stickers][stickers]   |   [VimDevIcons][vim-devicons]
[![GitHub release][img-version-badge]][repo] [![Gitter][img-gitter-badge]][gitter] [![Code of Conduct][coc-badge]][coc] [![PRs Welcome][prs-badge]][prs] 
**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][devicons], [Octicons][octicons], and others.
The following flow diagram shows the current glyph sets included:
 Diagram created using @SankeyMATIC 
## Important Notices
* `master` branch file paths are **not** considered stable. Verify your repository URI references
* cloning this repository is **not** recommended (due to Repo size) unless you are going to be contributing to development
## Table of Contents
**TL;DR**
**Installation Options**
 * **1 - Release Archive Download**
 * **2 - Homebrew Fonts (macOS/Linux)**
 * **3 - Install Script**
 * **4 - Chocolatey or Scoop (Windows)**
 * **5 - Arch Linux Repository (Extra, AUR)**
 * **6 - PowerShell Installer (Multi-Platform)**
 * **7 - Use Fontfallback**
 * **8 - Clone Repo**
 * **9 - Patch Your Own Font**
**Features**
 * **Glyph/Icon sets**
 * **Patched Fonts**
 * **Variations**
 * **Font Patcher**
**Developer / Contributor**
 * **Font Patcher**
 * **Gotta Patch 'em All Font Patcher!**
 * **Other Good Fonts to Patch**
 * **Contributing**
**Project Motivation**
**Additional Info**
 * **In case of problems**
 * **Unstable file paths on master**
 * **Changelog**
 * **License**
## TL;DR
 Nerd Fonts takes popular programming fonts and adds a bunch of Glyphs.
 There is also a 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..._
 * `Option 1.` want to download a **font family** package of variations (bold, italic, etc.) see download an archive
 * `Option 2.` are on **macOS** or **Linux** and want to use **Homebrew** see Homebrew Fonts
 * `Option 3.` want to **automate** installing or use in **scripts** see the Install Script
 * `Option 4.` are on **Windows** and want to use **Chocolatey** or **Scoop** see Unofficial Chocolatey or Scoop Repositories
 * `Option 5.` are on **Arch Linux** and want to use **Extra packages** see Arch Extra Repositories
 * `Option 6.` are using **PowerShell** and want an **interactive setup** or **use in scripts** see the PowerShell Installer
 * `Option 7.` want to install only one font for all fonts see Font Fallback
 * `Option 8.` want **complete control** then see cloning the repo
 * `Option 9.` want to patch your own font see the Font Patcher
## Features
* A FontForge Python script to patch any font
 * Includes an option to create **Monospaced (fixed-pitch, fixed-w