Table of Contents
- What does it look like?
- How do I report issues?
- Which font?
- How do I use glyphs in my terminal?
- Why do the glyphs look small, squished, or not full width?
- Why do some of the fonts names appear incorrect or appear to have typos?
- What do these acronym variations in the font name mean: LG, L, M, S, DZ, SZ?
- Why isn't my favorite font included?
- munmap_chunk(): invalid pointer
- segmentation fault running python patcher
- Font patching debugging
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
- What does it look like?
- How do I report issues?
- What are all these variations?
- Which font do I want?
- How do I use glyphs in my terminal
- Why do the glyphs look small, squished, or not full width?
- Why do some of the fonts names appear incorrect or appear to have typos?
- What do these acronym variations in the font name mean:
LG
,L
,M
,S
,DZ
,SZ
? - Why isn't my favorite font included (already patched)?
- Error: munmap_chunk(): invalid pointer
- segmentation fault running patcher
- Font patching debugging
What does it look like?
see Screenshots
How do I report issues?
see: Reporting Issues
Which font?
TL;DR
- Pick your font family and then select from the
'complete'
directory.- If you are on Windows pick a font with the
'Windows Compatible'
suffix.- This includes specific tweaks to ensure the font works on Windows, in particular monospace identification and font name length limitations
- If you are limited to monospaced fonts (because of your terminal, etc) then pick a font with the
'Mono'
suffix.- This denotes that the Nerd Font glyphs will be monospaced not necessarily that the entire font will be monospaced
- If you are on Windows pick a font with the
Explanation
Once you narrow down your font choice of family (Droid Sans
, Inconsolata
, etc) and style (bold
, italic
, etc) you have 2 main choices:
Option 1: Download already patched font
- download an already patched font from the
complete
folder- This is most likely the one you want. It includes all of the glyphs from all of the glyph sets. Only caution here is that some fonts have glyphs in the same code point so to include everything some had to be moved to alternate code points.
Option 2: Patch your own font
- patch your own variations with the various options provided by the font patcher (see each font's readme for full list of combinations available)
- This is the option you want if the font you use is not already included or you want maximum control of what's included
- This contains a list of all permutations of the various glyphs. E.g. You want the font with only Octicons or you want the font with just Font Awesome and Devicons. The goal is to provide every combination possible in this folder.
How do I use glyphs in my terminal?
echo $'\ue62b'
echo "5 digit codes: \Uf0004"
printf "or use printf instead of echo"
If echo
or printf
can do \u
or \U
depends on your concrete shell.
On linux you can enter unicodes directly with the key sequence ctrl
-shift
-u
f
0
0
0
4
enter
(example for f0004
).
Why do the glyphs look small, squished, or not full width?
Make sure your terminal supports double-width (aka full width ambiguous characters). Some terminal emulators (such as URxvt) do not work well or at all with such characters. If this is the case you will have to use the single-width (monospace) version of a given font or use a different terminal emulator.
For URxvt specific help or things to try see the wiki page Terminal Emulators URxvt
Why do some of the fonts names appear incorrect or appear to have typos?
Some of the patched fonts are intentionally renamed due to license restrictions to comply with SIL Open Font License (OFL). In particular the Reserved Font Names (RFNs)
What do these acronym variations in the font name mean: LG
, L
, M
, S
, DZ
, SZ
?
- LG - Line Gap
- L - Large
- M - Medium
- S - Small
- DZ - Dotted Zero
- SZ - Slashed Zero
This particularly applies to Meslo at the moment:
Meslo has changed it’s name to Meslo LG which now includes three variants: small, medium and large.
LG stands for Line Gap, so there’s one variant for smaller vertical line spacing, more towards Apple’s Menlo, a normal line gap (which equals Meslo v0.1) and a large gap, which is more than twice the space of Apple’s Menlo.
In addition to Regular, there’s Italic, Bold and Bold Italic font styles included for each LG variant.
source: https://github.com/andreberg/Meslo-Font
Why isn't my favorite font included?
It is most likely due to the font not being free or due to licensing reasons which prevent distributing or distributing modified versions.
E.g.
- Input Mono (license restriction)
- Possibly coming with external hosting :)
- PragmataPro (not free)
- Consolas (proprietary)
Most fonts you can freely modify on your own so feel free to try patching them on your own :)
munmap_chunk(): invalid pointer
Issue
[Font Patcher Py3] Error in python3': munmap_chunk(): invalid pointer
For the original details on the solution: comment on #129
Original Issue Reference: #129
Solutions
Option 1:
Downgrade Python to3.5.2-3
and FontForge to20161012-2
ref
Option 2:
Update to the latest FontForge version (issue has been fixed in recent versions)ref
Option 3:
Installaur/python35
instead of downgrading Pythonref
segmentation fault running python patcher
Issue
segmentation fault
For the original details on the solution: comment on #8
Original Issue Reference: #8
Solutions
Option 1:
Update FontForge and/or Python 2.x on macOS (OSX)Option 2:
Patch font on Linux
Font patching debugging
Issue
The font you patched is looking having some issues.
Solution
- You did take a backup of your old patched font before patching it again, didn't you?
- Look at the output of
font-patcher
after adding--debug 2
. Is there anything there that hints to the issue you are experiencing? - Copy and paste (as text) the strange icon into a unicode to codepoint converter. Then, search which font provides the glyph for that codepoint
fc-list :charset=xxxx
withxxxx
being the 4 digit hexadecimal codepoint you found from the above. This will tell you where the glyph is coming from. - nerdfix might be helpful. Although, fixing upstream is always better.
- Make sure that whatever is using the glyph has updated to the same version of Nerd Fonts that you are using. If not, they might be using deprecated glyph.
Home
Help
Glyph Sets & Codepoints
Icon Names in Shell
Font Substitution & Fallback
Codepoint Conflicts
Project Purpose
Development Guide
- Contributor Developer Setup
- Contributing Guide
- Development Workflow
- Release Workflow
- Pull Request Template
Real World Mentions & Usage (Sightings)
This Wiki and the Readme contains a lot of information, please take your time to read the information.
If you run into any trouble, please start by looking in the FAQ and if you still need help you can visit the Gitter Chat.
There is a heavily detailed Changelog and Release changes.
Be sure to read the Contributing Guide before opening a pull request to Nerd Fonts.
If you have any questions about the Nerd Fonts usage or want to share some information with the community, please go to one of the following places: