ryanoasis /nerd-fonts

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

★ 65,180⑂ 3,991👁 397⑃ 725● 1,169▤ 40◈ 163
CSSNOASSERTIONCreated 2014-12-05NerdFonts.com
65,180
stars
+12
3,991
forks
397
watchers
725
prs
1,169
issues
40
releases
163
discussions

README

[Releases][release]   |   Fonts   |   Font Patcher   |   [Wiki Documentation][wiki]   |   [Stickers][stickers]   |   [VimDevIcons][vim-devicons]


[![GitHub release][img-version-badge]][repo] [![Gitter][img-gitter-badge]][gitter] [![Code of Conduct][coc-badge]][coc] [![PRs Welcome][prs-badge]][prs]  





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][font-awesome], [Devicons][devicons], [Octicons][octicons], and others.

The following flow diagram shows the current glyph sets included:


  

Diagram created using @SankeyMATIC


 Important Notices
 master branch file paths are not considered stable. Verify your repository URI references
 cloning this repository is not recommended (due to Repo size) unless you are going to be contributing to development


 Table of Contents

TL;DR

Installation Options
   1 - Release Archive Download
   2 - Homebrew Fonts (macOS/Linux)
   3 - Install Script
   4 - Chocolatey or Scoop (Windows)
   5 - Arch Linux Repository (Extra, AUR)
   6 - PowerShell Installer (Multi-Platform)
   7 - Use Fontfallback
   8 - Clone Repo
   9 - Patch Your Own Font

Features
   Glyph/Icon sets
   Patched Fonts
   Variations
   Font Patcher

Developer / Contributor
   Font Patcher
   Gotta Patch 'em All Font Patcher!
   Other Good Fonts to Patch
   Contributing

Project Motivation

Additional Info
   In case of problems
   Unstable file paths on master
   Changelog
   License


 TL;DR
  Nerd Fonts takes popular programming fonts and adds a bunch of Glyphs.
  There is also a font patcher available if your desired font isn't already patched.
  For more high level information see the [wiki][wiki]. If you are looking for the Vim plugin see [VimDevIcons ➶][vim-devicons].

 Various Download Options for Fonts

_If you..._

   Option 1. want to download a font family package of variations (bold, italic, etc.) see download an archive
   Option 2. are on macOS or Linux and want to use Homebrew see Homebrew Fonts
   Option 3. want to automate installing or use in scripts see the Install Script
   Option 4. are on Windows and want to use Chocolatey or Scoop see Unofficial Chocolatey or Scoop Repositories
   Option 5. are on Arch Linux and want to use Extra packages see Arch Extra Repositories
   Option 6. are using PowerShell and want an interactive setup or use in scripts see the PowerShell Installer
   Option 7. want to install only one font for all fonts see Font Fallback
   Option 8. want complete control then see cloning the repo
   Option 9. want to patch your own font see the Font Patcher

 Features
 A FontForge Python script to patch any font
   Includes an option to create Monospaced (fixed-pitch, fixed-width) _or_ double-width (non-monos

Top issues

Discussions

Latest release

v3.5.1 v3.5.1 2026-08-21
It was too hot, we need a bugfix release this time.

 Bugs

 - Actually put in the new promised Devicons 2057
 - SpaceMono: Remove fi/fl ligs 2062
 - Flatten forgotten font subdirs

Full Changelog: https://github.com/ryanoasis/nerd-fonts/compare/v3.5.0...v3.5.1

Find the SHA checksums of the release artifacts here.
The .zip and .tar.xz archives have the same contents, just the xz is so much smaller.

Snapshot: 2026-11-10T09:35:25Z · Data license Apache-2.0 · JSON