Skip to content

FAQ and Troubleshooting

Ryan L McIntyre edited this page Aug 4, 2017 · 26 revisions

Nerd Fonts

  1. What does it look like?
  2. How do I report issues?
  3. What are all these variations?
  4. Which font do I want?
  5. Why do some of the fonts names appear incorrect or appear to have typos?
  6. Why isn't my favorite font included (already patched)?
  7. Error: munmap_chunk(): invalid pointer
  8. segmentation fault running patcher

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

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.

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)

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.

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 to 3.5.2-3 and FontForge to 20161012-2 ref
  • Option 2: Update to the latest FontForge version (issue has been fixed in recent versions) ref
  • Option 3: Install aur/python35 instead of downgrading Python ref

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