2015-07-05 18:34:19 +02:00
< h1 align = "center" >
< img src = "images/nerd-fonts-logo.png" alt = "nerd fonts" >
< / h1 >
2015-07-05 21:24:30 +02:00
[![GitHub version ](https://badge.fury.io/gh/ryanoasis%2Fnerd-fonts.svg )](http://badge.fury.io/gh/ryanoasis%2Fnerd-fonts)
2015-07-05 18:55:59 +02:00
***
2015-07-06 04:58:45 +02:00
| ** [Fonts ](#patched-fonts )** | ** [Patcher ](#font-patcher )** |
|-------------------------------------|-------------------------------|
2015-07-29 13:52:21 +02:00
| [![fonts-logo-small ](images/nerd-fonts-character-logo-md.png )](#patched-fonts) | [![patcher-logo-small ](images/nerd-fonts-patcher-logo-md.png )](#font-patcher) |
2015-07-05 18:55:59 +02:00
***
2014-12-05 06:29:54 +02:00
2015-06-28 15:33:52 +02:00
* A [fontforge python script ](#font-patcher ) to patch any font
2015-07-04 04:20:19 +02:00
* Over **20** already [patched font families ](#patched-fonts )
2015-07-05 03:11:30 +02:00
* Over **350** unique permutations/variations of patched fonts [(more details) ](#permutations )
2014-12-05 06:29:54 +02:00
2015-07-04 04:20:19 +02:00
## Table of Contents
2015-07-02 01:59:42 +02:00
- [font nerd icons ](# )
- [Glyph sets ](#glyph-sets )
- [Usage ](#usage )
- [Patched Fonts List ](#patched-fonts )
- [Permutations ](#permutations )
- [Font Install Script (Linux & Mac OS X) ](#font-install-script )
- [Font Patcher ](#font-patcher )
- [Gotta Patch 'em All Font Patcher! ](#gotta-patch-em-all )
- [Other Good Fonts to Patch ](#other-good-fonts-to-patch )
- [Rationale ](#rationale )
- [Other ](#other )
- [License ](#license )
## Glyph Sets
### Set 1: Seti-UI + Custom
2015-07-02 01:51:53 +02:00
* [Seti-UI] / icomoon plus misc custom glyphs
2015-06-24 01:46:19 +02:00
![image ](https://github.com/ryanoasis/nerd-filetype-glyphs-fonts-patcher/wiki/screenshots/v0.3.0/fontforge-glyph-set-1.png )
2015-03-01 19:59:09 +02:00
2015-07-02 01:59:42 +02:00
### Set 2: [devicons][vorillaz-devicons]
2015-07-02 01:51:53 +02:00
* [devicons][vorillaz-devicons] from [vorillaz-devicons]
2015-06-24 01:46:19 +02:00
![image ](https://github.com/ryanoasis/nerd-filetype-glyphs-fonts-patcher/wiki/screenshots/v0.3.0/fontforge-glyph-set-2.png )
2015-07-02 01:59:42 +02:00
### Set 3: [Pomicons][gabrielelana-pomicons]
2015-07-02 01:51:53 +02:00
* [Pomicons][gabrielelana-pomicons] from [gabrielelana-pomicons]
2015-06-24 02:47:06 +02:00
![image ](https://github.com/ryanoasis/nerd-filetype-glyphs-fonts-patcher/wiki/screenshots/v0.3.0/fontforge-glyph-set-3.png )
2015-06-24 01:46:19 +02:00
2015-07-02 01:59:42 +02:00
### Set 4: [powerline-extra-symbols][ryanoasis-powerline-extra-symbols]
2015-07-02 01:51:53 +02:00
* Work In Progress... :)
![image ](https://raw.githubusercontent.com/ryanoasis/powerline-extra-symbols/master/fontforge.png )
2014-12-05 06:29:54 +02:00
## Usage
2015-07-01 21:26:22 +02:00
### Option A
2015-01-22 03:04:51 +02:00
2015-06-28 15:33:52 +02:00
Install any of the already [provided patched fonts ](#patched-fonts )
2015-01-22 03:04:51 +02:00
### Option B
Use the provided python command line script to generate a patched font from your own font to get the additional new glyphs
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
2015-07-02 01:51:53 +02:00
| Font Name | em size | status |
2015-07-01 21:26:22 +02:00
|-------------------------------------------------------------------------------------------|----------|--------------------------|
2015-07-04 04:20:19 +02:00
| [3270 Plus Nerd File Types ](patched-fonts/3270 ) | 1000 | [TEST] |
| [Anonymice Powerline Plus Nerd File Types ](patched-fonts/AnonymousPro ) | 2048 | [TEST] |
| [Aurulent Sans Mono Plus Nerd File Types ](patched-fonts/AurulentSansMono ) | 1000 | [TEST] |
| [Bitstream Vera Sans Mono Plus Nerd File Types ](patched-fonts/BitstreamVeraSansMono ) | 2048 | [TEST] |
| [DejaVu Sans Mono Plus Nerd File Types ](patched-fonts/DejaVuSansMono ) | 2048 | [TEST] |
| [Droid Sans Mono for Powerline Plus Nerd File Types ](patched-fonts/DroidSansMono ) | 2048 | [TEST] |
| [Fira Mono for Powerline Plus Nerd File Types ](patched-fonts/FiraMono ) | 1000 | [TEST] |
| [Heavy Data Mono for Powerline Plus Nerd File Types ](patched-fonts/HeavyData ) | 2048 | [TEST] |
| [Inconsolata for Powerline Plus Nerd File Types ](patched-fonts/Inconsolata ) | 1000 | [TEST] |
| [Lekton for Powerline Plus Nerd File Types ](patched-fonts/Lekton ) | 1000 | [TEST] |
| [Literation Mono for Powerline Plus Nerd File Types ](patched-fonts/LiberationMono ) | 2048 | [TEST] |
| [Meslo for Powerline Plus Nerd File Types ](patched-fonts/Meslo ) | 2048 | [TEST] |
| [Monofur for Powerline Plus Nerd File Types ](patched-fonts/Monofur ) | 2400 | [TEST] |
| [M+ (MPlus) for Powerline Plus Nerd File Types ](patched-fonts/MPlus ) | 1000 | [TEST] |
| [ProFont (Windows tweaked) for Powerline Plus Nerd File Types ](patched-fonts/Profont ) | 1200 | [TEST] |
2015-07-01 21:26:22 +02:00
| [ProFont (x11) for Powerline Plus Nerd File Types ](patched-fonts/ProFont ) | 1000 | [FAIL] |
2015-07-13 00:32:08 +02:00
| [ProggyCleanTT Plus Nerd File Types ](patched-fonts/ProggyClean ) | 2048 | [MISSING POWERLINE GLYPHS ](https://github.com/ryanoasis/nerd-fonts/issues/16 ) |
2015-07-04 04:20:19 +02:00
| [Sauce Code Powerline Plus Nerd File Types ](patched-fonts/SourceCodePro ) | 1000 | [TEST] |
2015-07-13 00:32:08 +02:00
| [Terminess for Powerline Plus Nerd File Types ](patched-fonts/Terminus ) | 1000 | [FAIL ](https://github.com/ryanoasis/nerd-fonts/issues/16 ) |
2015-07-04 04:20:19 +02:00
| [Ubuntu Mono derivative Powerline Plus Nerd File Types ](patched-fonts/UbuntuMono ) | 1000 | [TEST] |
| [Ubuntu Mono Plus Nerd File Types ](patched-fonts/UbuntuMono ) | 1000 | [TEST] |
2015-07-01 21:26:22 +02:00
2015-07-02 01:51:53 +02:00
* Variations include:
* extra glyphs that are *double* or *single* (monospaced) width
2015-07-10 14:34:26 +02:00
* [Pomicons][gabrielelana-pomicons]
2015-07-02 01:51:53 +02:00
* Windows Compatible (WIP)
## Permutations
* Over 350 unique permutations/variations of patched fonts:
* 44 font variations (just counting otf and ttf)
* 8 permutations (1 no flags, 3 flagged options)
* Calculated Permutations (8 * 44) = 352
* Permutations for each font are any combination of (plus no flags option):
* Monospaced extra glyphs
* Windows Compatible
* [Pomicons][gabrielelana-pomicons]
2015-07-01 21:26:22 +02:00
2015-07-02 01:59:42 +02:00
## Font Install Script
* Linux & Mac OS X
2015-06-21 18:53:42 +02:00
> ./install.sh
### Examples
./install.sh
All fonts installed to /home/ryan/.fonts
2015-07-05 19:12:17 +02:00
< h2 align = "center" id = "font-patcher" >
< img src = "images/nerd-fonts-patcher-logo.png" alt = "Nerd Fonts Patcher" >
< / h2 >
2015-01-22 03:04:51 +02:00
Patching the font of your own choosing for use with the [vim-webdevicons ](https://github.com/ryanoasis/vim-webdevicons ) vim plugin:
2015-08-04 12:24:08 +02:00
* requires: python2, python-fontforge package (version 20141231 or later)
2014-12-05 06:29:54 +02:00
* usage:
2015-06-28 15:44:25 +02:00
```
./font-patcher PATH_TO_FONT
```
2014-12-05 06:29:54 +02:00
2015-03-01 19:59:09 +02:00
```
2015-06-24 01:55:26 +02:00
usage: font-patcher [-h] [-s] [-q] [-w] 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
(mainly for vim-webdevicons)
positional arguments:
font The path to the font to be patched (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
-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-06-24 01:55:26 +02:00
-w, --windows, --limit-font-name-length
Limit the internal font name to a maximum of 31
characters (for safe Windows compatiblity)
2015-07-01 21:26:22 +02:00
--pomicons Add Pomicon Glyphs
(https://github.com/gabrielelana/pomicons)
2015-03-01 19:59:09 +02:00
```
### Examples
./font-patcher unpatched-sample-fonts/Droid\ Sans\ Mono\ for\ Powerline.otf
./font-patcher unpatched-sample-fonts/Droid\ Sans\ Mono\ for\ Powerline.otf -s -q
./font-patcher unpatched-sample-fonts/Droid\ Sans\ Mono\ for\ Powerline.otf --use-single-width-glyphs --quiet
2015-06-24 01:55:26 +02:00
./font-patcher unpatched-sample-fonts/Droid\ Sans\ Mono\ for\ Powerline.otf -w
./font-patcher unpatched-sample-fonts/Droid\ Sans\ Mono\ for\ Powerline.otf --windows --quiet
2015-07-01 21:26:22 +02:00
./font-patcher unpatched-sample-fonts/Droid\ Sans\ Mono\ for\ Powerline.otf --windows --pomicons --quiet
2014-12-05 06:29:54 +02:00
./font-patcher Inconsolata.otf
2015-07-02 01:59:42 +02:00
< a name = "gotta-patch-em-all" > < / a >
2015-06-24 01:46:19 +02:00
## Gotta Patch 'em All Font Patcher!
* re-patches **all** fonts in the unpatched directory
* mostly for Contributor/Dev use only
2015-06-28 15:44:25 +02:00
```
./gotta-patch-em-all-font-patcher\!.sh
```
2015-07-02 01:59:42 +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:
* [Input Mono ](http://input.fontbureau.com/ )
* [PragmataPro ](http://www.fsd.it/fonts/pragmatapro.htm )
2015-06-24 01:46:19 +02:00
2015-06-28 15:33:52 +02:00
## Rationale
2015-06-24 01:46:19 +02:00
2015-06-28 15:33:52 +02:00
* Originally created for use with [vim-webdevicons] vim plugin to add glyphs (icons) as labels for files based on the filetype extension or entire path
2015-06-26 23:03:01 +02:00
## Other
2015-07-05 18:44:15 +02:00
* previously known as 'nerd-filetype-glyphs-fonts-patcher', 'font-nerd-icons'
2015-06-28 15:33:52 +02:00
2015-07-01 13:11:52 +02:00
## License
2015-06-28 15:33:52 +02:00
2015-07-01 13:11:52 +02:00
see [LICENSE ](LICENSE )
2015-06-28 15:33:52 +02:00
[vim-webdevicons]:https://github.com/ryanoasis/vim-webdevicons
[vorillaz-devicons]:http://vorillaz.github.io/devicons/
[gabrielelana-pomicons]:https://github.com/gabrielelana/pomicons
2015-07-01 21:26:22 +02:00
[Seti-UI]:https://atom.io/themes/seti-ui
2015-07-02 01:51:53 +02:00
[ryanoasis-powerline-extra-symbols]:https://github.com/ryanoasis/powerline-extra-symbols