nerdfonts/patcher
Patches developer targeted fonts with a high number of glyphs (icons).
Image
10
10K+
nerdfonts/patcher repository overview
About
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 ➶, Devicons ➶, Octicons ➶, and others.
Visit the website, project repository or wiki for more information.
Use the provided Docker image to patch your own font or to generate over 1.4 million unique combinations/variations (more details).
You can even specify a custom symbol font with the --custom option to include even more glyphs.
Usage
- Put your font(s) in a folder
- Create an output folder for the patched font files
- Spin up a container:
docker run -v /path/to/fonts:/in -v /path/for/output:/out nerdfonts/patcher [OPTIONS]
Options
| Option | Description |
|---|---|
-h, --help | Show help message and exit |
-v, --version | Show program's version number and exit |
-s, --mono, --use-single-width-glyphs | Whether to generate the glyphs as single-width not double-width (default is double-width) |
-l, --adjust-line-height | Whether to adjust line heights (attempt to center powerline separators more evenly) |
-q, --quiet, --shutup | Do not generate verbose output |
-w, --windows | Limit the internal font name to 31 characters (for Windows compatibility) |
-c, --complete | Add all available Glyphs |
--fontawesome | Add Font Awesome Glyphs |
--fontawesomeextension | Add Font Awesome Extension Glyphs |
--fontlinux, --fontlogos | Add Font Linux and other open source Glyphs |
--octicons | Add Octicons Glyphs |
--powersymbols | Add IEC Power Symbols |
--pomicons | Add Pomicon Glyphs |
--powerline | Add Powerline Glyphs |
--powerlineextra | Add Powerline Glyphs |
--material, --materialdesignicons, --mdi | Add Material Design Icons |
--weather, --weathericons | Add Weather Icons |
--custom [CUSTOM] | Specify a custom symbol font. All new glyphs will be copied, with no scaling applied. |
--postprocess [POSTPROCESS] | Specify a Script for Post Processing |
--removeligs, --removeligatures | Removes ligatures specified in JSON configuration file |
--configfile [CONFIGFILE] | Specify a file path for JSON configuration file (see sample: src/config.sample.json) |
--progressbars | Show percentage completion progress bars per Glyph Set |
--no-progressbars | Don't show percentage completion progress bars per Glyph Set |
--careful | Do not overwrite existing glyphs if detected |
-ext [EXTENSION], --extension [EXTENSION] | Change font file type to create (e.g., ttf, otf) |
Examples
docker run --rm -v ~/myfont/patchme:/in -v ~/myfont/patched:/out nerdfonts/patcher
docker run --rm -v ~/Desktop/myfont/patchme:/in -v ~/Desktop/myfont/patched:/out nerdfonts/patcher --fontawesome
Tag summary
Content type
Image
Digest
sha256:5afde49c2…
Size
42.1 MB
Last updated
about 1 month ago
docker pull nerdfonts/patcher