mirror of
https://github.com/ryanoasis/nerd-fonts.git
synced 2024-11-25 16:47:37 +02:00
Iconic font aggregator, collection, & patcher. 3,600+ icons, 50+ patched fonts: Hack, Source Code Pro, more. Glyph collections: Font Awesome, Material Design Icons, Octicons, & more
https://nerdfonts.com/
fontfont-awesomefontshacktoberfesticon-fonticonic-fontsocticonspatched-fontspatcherpowerlinepythonshellstatusline
a5e01e2401
* Added nerd font patcher logo large |
||
---|---|---|
glyph-source-fonts | ||
images | ||
patched-fonts | ||
unpatched-sample-fonts | ||
.gitignore | ||
changelog.md | ||
font-patcher | ||
gotta-patch-em-all-font-patcher!.sh | ||
install.sh | ||
LICENSE | ||
readme.md |
[![GitHub version](https://badge.fury.io/gh/ryanoasis%2Ffont-nerd-icons.svg)](http://badge.fury.io/gh/ryanoasis%2Ffont-nerd-icons) *** ### [Fonts](#patched-fonts) | [![patcher-logo-small](images/nerd-fonts-patcher-logo-sm.png)](#font-patcher) [Patcher](#font-patcher) ***
- A fontforge python script to patch any font
- Over 20 already patched font families
- Over 350 unique permutations/variations of patched fonts (more details)
Table of Contents
Glyph Sets
Set 1: Seti-UI + Custom
- Seti-UI / icomoon plus misc custom glyphs
Set 2: devicons
Set 3: Pomicons
Set 4: powerline-extra-symbols
Usage
Option A
Install any of the already provided patched fonts
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 for usage
- use this option if you do not want to use one of the fonts provided
Patched Fonts
- Variations include:
- extra glyphs that are double or single (monospaced) width
- Pomiconsgabrielelana-pomicons
- 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
Font Install Script
-
Linux & Mac OS X
./install.sh
Examples
./install.sh
All fonts installed to /home/ryan/.fonts
Patching the font of your own choosing for use with the vim-webdevicons vim plugin:
- requires: python2, python-fontforge package
- usage:
./font-patcher PATH_TO_FONT
usage: font-patcher [-h] [-s] [-q] [-w] font
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)
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
-w, --windows, --limit-font-name-length
Limit the internal font name to a maximum of 31
characters (for safe Windows compatiblity)
--pomicons Add Pomicon Glyphs
(https://github.com/gabrielelana/pomicons)
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
./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
./font-patcher unpatched-sample-fonts/Droid\ Sans\ Mono\ for\ Powerline.otf --windows --pomicons --quiet
./font-patcher Inconsolata.otf
Gotta Patch 'em All Font Patcher!
- re-patches all fonts in the unpatched directory
- mostly for Contributor/Dev use only
./gotta-patch-em-all-font-patcher\!.sh
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
- PragmataPro
Rationale
- 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
Other
- previously known as 'nerd-filetype-glyphs-fonts-patcher', 'font-nerd-icons'
License
see LICENSE