2015-08-11 00:33:21 +02:00
< h1 align = "center" >
2016-05-15 05:18:22 +02:00
< img src = "images/nerd-fonts-logo.png" alt = "nerd fonts" / >
2015-08-11 00:33:21 +02:00
< / h1 >
2015-11-11 17:23:50 +02:00
2016-11-18 06:46:22 +02:00
[![GitHub version][img-version-badge]][badge-version] [![Join the chat at https://gitter.im/ryanoasis/nerd-fonts][img-gitter-badge]][badge-gitter] [![Windows Logo][w-top]](#patched-fonts "↓ Windows Compatibility Status ↓") [![macOS (OSX) Logo][m-top]](#patched-fonts "↓ macOS (OSX) Compatibility Status ↓") [![Linux Logo][l-top]](#patched-fonts "↓ Linux Compatibility Status ↓")
[![GitHub release ](https://img.shields.io/github/release/ryanoasis/nerd-fonts.svg?style=flat-square&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAACcAAAAOCAMAAACb3vX5AAAAJ1BMVEX%2F%2F%2F%2F%2Fzj5oY2P%2F5Zj%2FzTj%2F23D%2B9d3%2F7rv%2FyzLf3d22s7NuaWn%2FySpP6xHaAAAAAXRSTlMAQObYZgAAAGhJREFUeNp9kVEKgEAIBRX86KP7nzfEddSEFbJ1nBdU4qVZUlXY%2BiAj8Bazswdg0ns2Ee14aRCDIcdFX9m7x1Z1eV4YbAOat75usfUKy%2BPGQ2eWYXnyY9PnVKyg5cn4nE%2BAGvbvglAdfRV3AOfeqRdeAAAAAElFTkSuQmCC )](https://github.com/ryanoasis/nerd-fonts)
[![Gitter ](https://img.shields.io/gitter/room/nwjs/nw.js.svg?style=flat-square )](https://gitter.im/ryanoasis/nerd-fonts)
2016-11-18 05:44:34 +02:00
2016-10-22 17:40:41 +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-05-15 05:18:22 +02:00
< h1 align = "center" >
2016-11-18 06:37:05 +02:00
< img src = "https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/sankey-glyphs-combined-diagram.png" alt = "@SankeyMATIC Diagram" / >
2016-05-15 05:18:22 +02:00
< / h1 >
2016-03-20 19:15:28 +02:00
< sub > _Diagram created using [@SankeyMATIC ](http://sankeymatic.com/ )_</ sub >
2016-10-22 18:54:47 +02:00
The best way to get the fonts is to [download ](#patched-fonts ) the specific one you want
Cloning of this repository is **not** required nor the most efficient way to get the fonts,
2016-10-23 23:20:06 +02:00
however if you want all the fonts and want to clone be sure to shallow clone:
2016-10-22 18:54:47 +02:00
> `git clone --depth 1`
2016-05-15 20:03:03 +02:00
For more high level information see the [wiki][wiki]. If you are looking for the Vim plugin see [vim-devicons ➶][vim-devicons].
2016-03-20 19:15:28 +02:00
## Quick Links
2016-05-15 05:30:32 +02:00
2016-03-15 14:47:29 +02:00
| ** [Fonts ](#patched-fonts )** | ** [Patcher ](#font-patcher )** | ** [Vim Plugin ➶][vim-devicons]** |
|-----------------------------|------------------------------|----------------------------------|
| [![fonts-logo-small ](images/nerd-fonts-character-logo-md.png )](#patched-fonts) | [![patcher-logo-small ](images/nerd-fonts-patcher-logo-md.png )](#font-patcher) | [![vim-devicons-logo-small][img-visual-toc-vim-devicons]][vim-devicons] |
2015-08-11 00:33:21 +02:00
2016-10-22 18:54:47 +02:00
## Important Notices
* _`master`_ branch file paths are _not_ considered stable. [Please read if you are directly referencing the repository URI ](#unstable-file-paths )
* cloning this repository is **not** recommended unless you are going to be [contributing to development ](#contributing )
2016-03-15 14:47:29 +02:00
2016-05-15 05:30:32 +02:00
## Features
* A [FontForge python script ](#font-patcher ) to patch any font
* **26** already [patched font families ](#patched-fonts )
* Over **5,700** unique combinations/variations of patched fonts [(more details) ](#combinations )
* Over **1,000** glyphs/icons combined [(more details) ](#combinations )
2016-05-15 20:03:03 +02:00
* Current glyph sets include: [Powerline with Extra Symbols][ryanoasis-powerline-extra-symbols], [Font Awesome][font-awesome], [Devicons][vorillaz-devicons], [Octicons][octicons], [Font Linux][font-linux], [Pomicons][gabrielelana-pomicons]
2016-05-15 05:30:32 +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
## Table of Contents
2015-09-25 15:53:27 +02:00
2016-03-15 15:03:39 +02:00
- [Glyph sets ](#glyph-sets )
- [Usage ](#usage )
- [Patched Fonts List ](#patched-fonts )
- [Combinations ](#combinations )
- [Font Installation ](#font-installation )
- [Font Install Script (Linux & Mac OS X) ](#font-install-script )
- [Font Patcher ](#font-patcher )
- [Gotta Patch 'em All Font Patcher! ](#gotta-patch-em-all )
- [Unstable file paths on master ](#unstable-file-paths )
- [Other Good Fonts to Patch ](#other-good-fonts-to-patch )
2016-05-15 20:03:03 +02:00
- [Project History ](#project-history )
- [Motivation ](#motivation-original-rationale )
- [Contributing ](#contributing )
- [Changelog ](#changelog )
2016-03-15 15:03:39 +02:00
- [License ](#license )
2015-08-11 00:33:21 +02:00
## Glyph Sets
### Seti-UI + Custom
2016-10-22 17:40:41 +02:00
> Based off of [Seti-UI] Icomoon with extra custom glyphs.
2015-11-26 17:08:46 +02:00
2016-11-18 06:37:05 +02:00
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-1.png )
2015-08-11 00:33:21 +02:00
2015-11-26 17:08:46 +02:00
### [Devicons][vorillaz-devicons]
> An iconic font made for developers, code jedis, ninjas, HTTPsters, evangelists and nerds(sic). / ([repo][vorillaz-devicons]) / ([website](http://vorillaz.github.io/devicons))
2016-11-18 06:37:05 +02:00
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-2.png )
2015-08-11 00:33:21 +02:00
2015-11-26 17:08:46 +02:00
### [Font Awesome][font-awesome]
> The iconic font and CSS toolkit. / ([repo][font-awesome]) / ([website](https://fortawesome.github.io/Font-Awesome))
2016-11-18 06:37:05 +02:00
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-font-awesome-1.png )
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-font-awesome-2.png )
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-font-awesome-3.png )
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-font-awesome-4.png )
2016-10-30 00:47:36 +02:00
### [Font Awesome Extension][font-awesome-extension]
> Simple Font Awesome Extension. / ([repo][font-awesome-extension]) / ([website](http://andrelgava.github.io/font-awesome-extension/))
2016-11-18 06:37:05 +02:00
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-font-awesome-extension-1.png )
2015-08-11 00:33:21 +02:00
2015-11-26 17:08:46 +02:00
### [Octicons][octicons]
> GitHub's icons. / ([repo][octicons]) / ([website](https://octicons.github.com))
2016-11-18 06:37:05 +02:00
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-octicons.png )
2015-08-11 00:33:21 +02:00
2015-11-26 17:08:46 +02:00
### [Powerline Extra Symbols][ryanoasis-powerline-extra-symbols]
2016-10-22 17:40:41 +02:00
> Provides extra Powerline separator glyphs and a column number glyph (CN). / ([repo][ryanoasis-powerline-extra-symbols])
2015-11-26 17:08:46 +02:00
2015-08-11 00:33:21 +02:00
![image ](https://raw.githubusercontent.com/ryanoasis/powerline-extra-symbols/master/fontforge.png )
2015-03-10 00:25:57 +02:00
2016-10-30 00:51:57 +02:00
### [IEC Power Symbols][website-iecpower]
2016-10-30 00:47:36 +02:00
> Adding new characters into Unicode / ([website][website-iecpower])
2016-11-18 06:37:05 +02:00
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-font-iec-power-1.png )
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-font-iec-power-2.png )
2016-10-30 00:47:36 +02:00
2016-05-08 22:58:54 +02:00
### [Font Linux][font-linux]
> Font-linux is an icon font containing logos of popular linux distributions for inclusion in websites. / ([repo][font-linux])
2016-11-18 06:37:05 +02:00
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-font-linux.png )
2016-05-08 22:58:54 +02:00
### [Pomicons][gabrielelana-pomicons]
> 8 symbols for the ["Pomodoro Technique"®](http://pomodorotechnique.com). / ([repo][gabrielelana-pomicons])
2016-11-18 06:37:05 +02:00
![image ](https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/fontforge-glyph-set-pomicons.png )
2016-05-08 22:58:54 +02:00
2014-12-05 06:29:54 +02:00
## Usage
2015-11-26 17:08:46 +02:00
#### Option A
2015-01-22 03:04:51 +02:00
2015-08-11 00:33:21 +02:00
Install any of the already [provided patched fonts ](#patched-fonts )
2015-01-22 03:04:51 +02:00
2015-11-26 17:08:46 +02:00
#### Option B
2015-01-22 03:04:51 +02:00
2016-10-22 17:40:41 +02:00
Use the provided python command line script to generate a patched font from your own font to get the extra new glyphs
2015-01-22 03:04:51 +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 )
2014-12-05 06:29:54 +02:00
## Patched Fonts
2016-05-08 21:15:43 +02:00
| Font Name | Font Name and Repository | *RFN | EM Size | Status |
2016-05-08 23:09:12 +02:00
|---------------------------------------------------|-----------------------------|------|---------|-------------------|
2016-11-18 04:19:19 +02:00
| [3270 Nerd Font][p-3270] | [3270][f-3270] | NO | 1000 | ![w2]![m2]![l2] |
| [Anonymice Nerd Font][p-anonymous-pro] | [Anonymous Pro][f-a-pro] | NO | 2048 | ![w2]![m2]![l2] |
| [Aurulent Sans Mono Nerd Font][p-aurulent] | | NO | 1000 | ![w2]![m2]![l2] |
| [Bitstream Vera Sans Mono Nerd Font][p-bitstream] | | NO | 2048 | ![w2]![m2]![l2] |
| [Code New Roman Nerd Font][p-code-nr] | | NO | 2048 | ![w2]![m2]![l2] |
| [DejaVu Sans Mono Nerd Font][p-dejavu] | | NO | 2048 | ![w2]![m2]![l2] |
| [Droid Sans Mono Nerd Font][p-droid] | | NO | 2048 | ![w2]![m2]![l2] |
| [Fantasque Sans Nerd Font][p-fantasque] | [Fantasque Sans][f-fant] | NO | 2048 | ![w2]![m2]![l2] |
| [Fura Code Nerd Font][p-fira-code] | [Fira][f-fira-code] | YES | 1000 | ![w2]![m2]![l2] |
| [Fura Mono Nerd Font][p-fira-mono] | [Fira][f-fira-mono] | YES | 1000 | ![w2]![m2]![l2] |
| [Gohu Nerd Font][p-gohu] | [Gohu][f-gohu] | NO | 1000 | ![w2]![m2]![l2] |
| [Hasklug Nerd Font][p-hasklig] | [Hasklig][f-hasklig] | YES | 1000 | ![w2]![m2]![l2] |
| [Heavy Data Mono Nerd Font][p-heavy-data] | | NO | 2048 | ![w2]![m2]![l2] |
| [Hermut Nerd Font][p-hermit] | | NO | 1000 | ![w2]![m2]![l2] |
| [Inconsolata Nerd Font][p-inconsolata] | | NO | 1000 | ![w2]![m2]![l2] |
2016-10-22 21:30:28 +02:00
| [Iosevka Nerd Font][p-iosevka] | [Iosevka][f-iosevka] | YES | 1000 | [#83][s-iosevka] |
2016-05-08 21:15:43 +02:00
| [Knack Nerd Font][p-hack] | [Hack][f-hack] | YES | 2048 | [#70][s-hack] |
2016-11-18 04:19:19 +02:00
| [Lekton Nerd Font][p-lekton] | | NO | 1000 | ![w2]![m2]![l2] |
| [Literation Mono Nerd Font][p-liberation] | [Liberation][f-liberation] | YES | 2048 | ![w2]![m2]![l2] |
| [Meslo Nerd Font][p-meslo] | | NO | 2048 | ![w2]![m2]![l2] |
| [Monofur Nerd Font][p-monofur] | | NO | 2400 | ![w2]![m2]![l2] |
| [Monoid Nerd Font][p-monoid] | | NO | 1536 | ![w2]![m2]![l2] |
| [Mononoki Nerd Font][p-mononoki] | [Mononoki][f-mononoki] | NO | 1024 | ![w2]![m2]![l2] |
| [M+ (MPlus) Nerd Font][p-mplus] | | NO | 1000 | ![w2]![m2]![l2] |
| [ProFont (Windows tweaked) Nerd Font][p-profont] | | NO | 1200 | ![w2]![m2]![l2] |
2016-05-08 21:15:43 +02:00
| [ProFont (x11) Nerd Font][p-profont] | | NO | 1000 | [FAILING] |
| [ProggyClean Nerd Font][p-proggy-clean] | | NO | 2048 | [FAILING] |
| [Roboto Mono][p-roboto] | | NO | 2048 | [FAILING] |
2016-11-18 04:19:19 +02:00
| [Sauce Code Nerd Font][p-source-code-pro] | [Source][f-source] | YES | 1000 | ![w2]![m2]![l2] |
| [Shure Tech Mono Nerd Font][p-share-tech-mono] | [Share Tech Mono][f-share] | YES | 1000 | ![w2]![m2]![l2] |
| [Space Mono Nerd Font][p-space-mono] | [Space Mono][f-space] | NO | 1000 | ![w2]![m2]![l2] |
2016-05-08 21:15:43 +02:00
| [Terminess Nerd Font][p-terminus] | [Terminus Font][f-terminus] | YES | 1000 | [#16][s-terminus] |
2016-11-18 04:19:19 +02:00
| [Ubuntu Mono derivative Nerd Font][p-ubuntu] | | NO | 1000 | ![w2]![m2]![l2] |
| [Ubuntu Mono Nerd Font][p-ubuntu] | | NO | 1000 | ![w2]![m2]![l2] |
2016-05-08 21:15:43 +02:00
< sub > _*RFN = Reserved Font Name_< / sub >
2015-08-11 00:33:21 +02:00
* Variations include:
* extra glyphs that are *double* or *single* (monospaced) width
* [Font Awesome][font-awesome]
* [GitHub Octicons][octicons]
2016-05-08 22:58:54 +02:00
* [Font Linux][font-linux]
2015-08-11 00:33:21 +02:00
* [Pomicons][gabrielelana-pomicons]
* Full Windows Compatibility (WIP)
## Combinations
2016-05-14 16:35:33 +02:00
* Over 5,700 unique variations/combinations (Power Set) of patched fonts:
2016-10-22 17:40:41 +02:00
* 102 unpatched font variations (counting otf and ttf)
* 56 combinations (Includes [Powerline Extra Symbols][ryanoasis-powerline-extra-symbols])
2016-05-14 16:35:33 +02:00
* Calculated combinations (56 * 102) = 5,712
2015-08-11 00:33:21 +02:00
* Combinations for each font are any combination of (plus no flags option):
* Monospaced extra glyphs
* Windows Compatible
* [Font Awesome][font-awesome]
* [GitHub Octicons][octicons]
2016-05-08 22:58:54 +02:00
* [Font Linux][font-linux]
2015-08-11 00:33:21 +02:00
* [Pomicons][gabrielelana-pomicons]
2015-11-23 01:50:15 +02:00
## Font Installation
Put any font you would like to use into the `~/.local/share/fonts` (Linux) or `~/Library/Fonts/` (OS X) folder. For example:
Linux
```sh
mkdir -p ~/.local/share/fonts
2016-02-05 00:23:37 +02:00
cd ~/.local/share/fonts & & curl -fLo "Droid Sans Mono for Powerline Nerd Font Complete.otf" https://raw.githubusercontent.com/ryanoasis/nerd-fonts/master/patched-fonts/DroidSansMono/complete/Droid%20Sans%20Mono%20for%20Powerline%20Nerd%20Font%20Complete.otf
2015-11-23 01:50:15 +02:00
```
2016-10-22 17:40:41 +02:00
deprecated alternative paths: `~/.fonts`
2015-11-23 01:50:15 +02:00
OS X
```sh
2016-02-05 00:23:37 +02:00
cd ~/Library/Fonts & & curl -fLo "Droid Sans Mono for Powerline Nerd Font Complete.otf" https://raw.githubusercontent.com/ryanoasis/nerd-fonts/master/patched-fonts/DroidSansMono/complete/Droid%20Sans%20Mono%20for%20Powerline%20Nerd%20Font%20Complete.otf
2015-11-23 01:50:15 +02:00
```
2015-11-26 17:08:46 +02:00
2015-08-11 00:33:21 +02:00
## Font Install Script
2015-11-24 15:23:17 +02:00
2015-08-11 00:33:21 +02:00
* Linux & Mac OS X
2016-11-18 07:13:10 +02:00
### Install all fonts:
2016-05-15 05:13:49 +02:00
2016-10-22 17:40:41 +02:00
* Installs all the patched Fonts (_Warning: This is a lot of Fonts adding up to a large size_)
2016-05-15 05:13:49 +02:00
2015-11-24 15:30:00 +02:00
```sh
./install.sh
```
2015-08-11 00:33:21 +02:00
2016-11-18 07:13:10 +02:00
### Install a single font:
2016-05-15 05:13:49 +02:00
2016-05-09 10:44:55 +02:00
```sh
./install.sh < FontName >
./install.sh Hack
./install.sh HeavyData
```
2015-08-11 00:33:21 +02:00
< h2 align = "center" id = "font-patcher" >
< img src = "images/nerd-fonts-patcher-logo.png" alt = "Nerd Fonts Patcher" >
< / h2 >
Patching the font of your own choosing for use with the [vim-devicons ](https://github.com/ryanoasis/vim-devicons ) vim plugin:
2015-08-04 13:12:55 +02:00
* requires: python2, python-fontforge package (version 20141231 or later, see
the [install instructions ](http://designwithfontforge.com/en-US/Installing_Fontforge.html ))
2016-10-22 17:40:41 +02:00
* alternative install method on OSX: `brew install fontforge`
2015-11-11 03:19:56 +02:00
* Usage:
2014-12-05 06:29:54 +02:00
2015-08-11 00:33:21 +02:00
```
./font-patcher PATH_TO_FONT
```
2014-12-05 06:29:54 +02:00
2016-10-22 17:40:41 +02:00
* Alternative usage: Execute the patcher with the FontForge binary using the script flag:
2015-11-11 03:19:56 +02:00
```
./fontforge -script font-patcher PATH_TO_FONT
```
2015-03-01 19:59:09 +02:00
```
2016-10-23 23:23:00 +02:00
usage: font-patcher [-h] [-v] [-s] [-q] [-w] [-c] [--fontawesome]
[--fontawesomeextension] [--fontlinux] [--octicons]
[--powersymbols] [--pomicons] [--powerline]
[--powerlineextra] [--careful] [-ext [EXTENSION]]
[-out [OUTPUTDIR]]
2015-08-11 00:33:21 +02:00
font
2014-12-05 06:29:54 +02:00
2015-03-01 19:59:09 +02:00
Patches a given font with programming and web development related glyphs
2015-08-11 00:33:21 +02:00
(mainly for https://github.com/ryanoasis/vim-devicons)
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
2015-03-01 19:59:09 +02:00
optional arguments:
-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
2015-03-01 19:59:09 +02:00
-s, --use-single-width-glyphs
Whether to generate the glyphs as single-width not
double-width (default is double-width)
-q, --quiet, --shutup
Do not generate verbose output
2015-08-11 00:33:21 +02:00
-w, --windows, --limit-font-name-length
2016-10-23 23:23:00 +02:00
Limit the internal font name to 31 characters (for
Windows compatibility)
-c, --complete Add all available Glyphs
2015-08-11 00:33:21 +02:00
--fontawesome Add Font Awesome Glyphs (http://fortawesome.github.io
2016-05-08 22:58:54 +02:00
/Font-Awesome)
2016-10-23 23:23:00 +02:00
--fontawesomeextension
Add Font Awesome Extension Glyphs
(http://andrelgava.github.io/font-awesome-extension)
2016-05-08 22:58:54 +02:00
--fontlinux Add Font Linux Glyphs (https://github.com/Lukas-W
/font-linux)
--octicons Add Octicons Glyphs (https://octicons.github.com)
2016-10-23 23:23:00 +02:00
--powersymbols Add IEC Power Symbols (http://unicodepowersymbol.com)
2015-08-11 00:33:21 +02:00
--pomicons Add Pomicon Glyphs
(https://github.com/gabrielelana/pomicons)
2015-11-16 01:50:11 +02:00
--powerline Add Powerline Glyphs
--powerlineextra Add Powerline Glyphs (https://github.com/ryanoasis
/powerline-extra-symbols)
--careful Do not overwrite existing glyphs if detected
2016-10-23 23:23:00 +02:00
-ext [EXTENSION], --extension [EXTENSION]
Change font file type to create (e.g., ttf, otf)
2015-11-16 01:50:11 +02:00
-out [OUTPUTDIR], --outputdir [OUTPUTDIR]
The directory to output the patched font file to
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
2016-11-18 07:13:10 +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 Droid\ Sans\ Mono\ for\ Powerline.otf -w
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf --windows --quiet
./font-patcher Droid\ Sans\ Mono\ for\ Powerline.otf --windows --pomicons --quiet
2015-08-11 00:33:21 +02:00
./font-patcher Inconsolata.otf --fontawesome
./font-patcher Inconsolata.otf --fontawesome --octicons --pomicons
2014-12-05 06:29:54 +02:00
./font-patcher Inconsolata.otf
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:
2015-08-11 00:33:21 +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-08-11 00:33:21 +02:00
./gotta-patch-em-all-font-patcher\!.sh Hermit
```
2015-11-11 17:23:50 +02:00
2016-11-18 07:13:10 +02:00
## Unstable File Paths
2015-11-11 17:23:50 +02:00
| Unstable file paths warning |
-------------------------------
2016-11-18 07:13:10 +02:00
| Reference the **release** branch and _not_ the ~~master~~ branch because paths are subject change for each release |
| For example: |
| Use: https://github.com/ryanoasis/nerd-fonts/blob/0.9.0/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf |
| Not: ~~https://github.com/ryanoasis/nerd-fonts/blob/master/patched-fonts/Hermit/Medium/complete/Hurmit%20Medium%20Nerd%20Font%20Complete.otf~~ |
2015-11-11 17:23:50 +02:00
2015-08-11 00:33:21 +02:00
## Other Good Fonts to Patch
* a list of additional good fonts to patch that I cannot provide or share due to the license:
2016-10-23 23:23:00 +02:00
* [Input Mono][input-mono] (license restriction)
* Possibly coming with external hosting :)
* [PragmataPro][pragmatapro] (not free)
* [Consolas][consolas] (proprietary)
2015-08-11 00:33:21 +02:00
2016-05-15 05:13:49 +02:00
## Project History
2015-08-11 00:33:21 +02:00
2016-05-15 05:13:49 +02:00
### Motivation (Original Rationale)
2015-08-11 00:33:21 +02:00
2016-10-22 17:40:41 +02:00
* Originally created for use with [vim-devicons] vim plugin to add glyphs (icons) as labels for files based on the filetype extension or entire path. This project began as a part of the [vim-devicons] repo but soon it became apparent it did not belong tied to the vim plugin. I thought it may benefit others more as a separate project and allow a wider range of uses. This project started before I knew about Fontconfig provided solution, although a patched font still has some benefits over the Fontconfig.
2015-08-11 00:33:21 +02:00
2016-05-15 05:13:49 +02:00
* project and repository previously known as 'nerd-filetype-glyphs-fonts-patcher' and 'font-nerd-icons'
2015-08-11 00:33:21 +02:00
2016-05-15 20:03:03 +02:00
## Contributing
2016-05-15 20:04:35 +02:00
See [contributing.md ](contributing.md )
2016-05-15 20:03:03 +02:00
## Changelog
See [changelog.md ](changelog.md )
2014-12-05 06:29:54 +02:00
## License
2016-05-15 20:04:35 +02:00
[MIT ](LICENSE ) © Ryan L McIntyre
2015-08-11 00:33:21 +02:00
2016-05-08 22:58:54 +02:00
<!--
Repo References
-->
2015-08-11 00:33:21 +02:00
[vim-devicons]:https://github.com/ryanoasis/vim-devicons
[vorillaz-devicons]:http://vorillaz.github.io/devicons/
[font-awesome]:https://github.com/FortAwesome/Font-Awesome
2016-10-30 00:47:36 +02:00
[font-awesome-extension]:https://github.com/AndreLGava/font-awesome-extension
2015-08-11 00:33:21 +02:00
[octicons]:https://github.com/github/octicons
2016-05-08 22:58:54 +02:00
[font-linux]:https://github.com/Lukas-W/font-linux
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
2016-03-15 15:03:39 +02:00
[wiki]:https://github.com/ryanoasis/nerd-fonts/wiki
2015-10-15 04:21:16 +02:00
2016-10-30 00:47:36 +02:00
<!--
Website References
-->
[website-iecpower]:http://unicodepowersymbol.com/
2016-05-08 22:58:54 +02:00
<!--
2015-10-15 04:21:16 +02:00
Link References
-->
[badge-version]:http://badge.fury.io/gh/ryanoasis%2Fnerd-fonts
[badge-gitter]:https://gitter.im/ryanoasis/nerd-fonts?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge
[img-version-badge]:https://badge.fury.io/gh/ryanoasis%2Fnerd-fonts.svg
2015-12-01 16:55:34 +02:00
[img-gitter-badge]:https://img.shields.io/gitter/room/nwjs/nw.js.svg?style=flat
2016-03-15 14:47:29 +02:00
[img-visual-toc-vim-devicons]:https://raw.githubusercontent.com/wiki/ryanoasis/vim-devicons/screenshots/v1.0.0/branding-logo-sm.png
2016-03-20 21:56:48 +02:00
2016-10-23 23:23:00 +02:00
[consolas]:https://www.microsoft.com/typography/fonts/family.aspx?FID=300
[input-mono]:http://input.fontbureau.com/download/
[pragmatapro]:http://www.fsd.it/shop/fonts/pragmatapro/
2016-03-20 21:56:48 +02:00
<!--
Font repos
-->
2016-05-08 22:58:54 +02:00
2016-05-08 21:15:43 +02:00
[f-hack]:https://github.com/chrissimpkins/Hack
2016-05-08 21:31:21 +02:00
[f-a-pro]:http://www.marksimonson.com/fonts/view/anonymous-pro
2016-10-22 16:53:46 +02:00
[f-3270]:https://github.com/rbanffy/3270font
2016-05-08 21:15:43 +02:00
[f-source]:https://github.com/adobe-fonts/source-code-pro
[f-liberation]:https://fedorahosted.org/liberation-fonts
[f-terminus]:http://terminus-font.sourceforge.net
[f-fira-mono]:https://github.com/mozilla/Fira
[f-fira-code]:https://github.com/tonsky/FiraCode
[f-monoid]:https://github.com/larsenwork/monoid
[f-iosevka]:https://github.com/be5invis/Iosevka
2016-05-08 21:31:21 +02:00
[f-fant]:https://github.com/belluzj/fantasque-sans
2016-10-22 21:30:28 +02:00
[f-share]:https://fonts.google.com/specimen/Share+Tech+Mono
[f-space]:https://fonts.google.com/specimen/Space+Mono
[f-gohu]:http://font.gohu.org/
[f-mononoki]:http://madmalik.github.io/mononoki/
[f-hasklig]:https://github.com/i-tu/Hasklig
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
2016-05-08 21:15:43 +02:00
[p-3270]:patched-fonts/3270
2016-05-08 23:09:12 +02:00
[p-anonymous-pro]:patched-fonts/AnonymousPro
2016-05-08 21:15:43 +02:00
[p-aurulent]:patched-fonts/AurulentSansMono
[p-bitstream]:patched-fonts/BitstreamVeraSansMono
[p-dejavu]:patched-fonts/DejaVuSansMono
[p-droid]:patched-fonts/DroidSansMono
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
[p-heavy-data]:patched-fonts/HeavyData
[p-hermit]:patched-fonts/Hermit
[p-inconsolata]:patched-fonts/Inconsolata
[p-iosevka]:patched-fonts/Iosevka
[p-hack]:patched-fonts/Hack
[p-lekton]:patched-fonts/Lekton
[p-liberation]:patched-fonts/LiberationMono
[p-meslo]:patched-fonts/Meslo
[p-monofur]:patched-fonts/Monofur
[p-monoid]:patched-fonts/Monoid
[p-mplus]:patched-fonts/MPlus
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
[p-source-code-pro]:patched-fonts/SourceCodePro
[p-terminus]:patched-fonts/Terminus
[p-ubuntu]:patched-fonts/UbuntuMono
2016-10-22 21:30:28 +02:00
[p-share-tech-mono]:patched-fonts/ShareTechMono
[p-space-mono]:patched-fonts/SpaceMono
[p-gohu]:patched-fonts/Gohu
[p-mononoki]:patched-fonts/Mononoki
[p-code-nr]:patched-fonts/CodeNewRoman
[p-hasklig]:patched-fonts/Hasklig
2016-05-08 21:15:43 +02:00
<!--
Patched Font Statuses
-->
2016-05-08 22:58:54 +02:00
2016-11-18 06:46:22 +02:00
[w-top]:https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/windows-pass-sm.png
[l-top]:https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/linux-pass-sm.png
[m-top]:https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/mac-pass-sm.png
[w]:https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/windows-pass-sm.png "Windows status is working ☺"
[l]:https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/linux-pass-sm.png "Linux status is working ☺"
[m]:https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/mac-pass-sm.png "macOS (OSX) status is working ☺"
2016-11-18 04:57:07 +02:00
2016-11-18 06:46:22 +02:00
[w2]:https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/windows-unknown-sm.png "Windows status is Unknown/Un-tested"
[l2]:https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/linux-unknown-sm.png "Linux status is Unknown/Un-tested"
[m2]:https://github.com/ryanoasis/nerd-fonts/wiki/screenshots/v0.9.x/mac-unknown-sm.png "macOS (OSX) status is Unknown/Un-tested"
2016-11-18 04:19:19 +02:00
2016-05-08 21:15:43 +02:00
[s-hack]:https://github.com/ryanoasis/nerd-fonts/issues/70
[s-terminus]:https://github.com/ryanoasis/nerd-fonts/issues/16
2016-05-14 17:18:12 +02:00
[s-iosevka]:https://github.com/ryanoasis/nerd-fonts/issues/83