Repolode
ryanoasis

ryanoasis/nerd-fonts

Patches developer fonts such as Hack and Source Code Pro with thousands of icons from Font Awesome, Devicons, Octicons and other icon sets.

Stars
64,920
Forks
3,957
Open issues
27
Last commit
2 days ago

What is it?

Nerd Fonts takes popular programming fonts and adds a large set of glyphs (icons) drawn from popular iconic font collections such as Font Awesome, Devicons, Octicons, Material Design Icons and Powerline symbols. The result is a family of patched fonts that can display these icons directly in a terminal, editor or status line, which is useful for shell prompts, file-tree views and statusline plugins.

The project ships a large catalog of pre-patched fonts, with dozens of families available as release archives, Homebrew casks, Arch packages and an install script. Each font comes in monospaced, double-width and proportional glyph variants. Icons can be looked up by name in shell scripts and through a searchable cheat sheet on the project website.

For fonts that are not already in the collection, the repository includes a FontForge-based Python font patcher, along with a Docker image that runs it. The patcher lets you choose which glyph sets to add, and a batch script can re-patch the full collection.

Key features

  • 01Adds thousands of icons from Font Awesome, Devicons, Octicons, Material Design Icons and other sets to developer fonts.
  • 02Provides more than 60 pre-patched font families.
  • 03Offers monospaced, double-width and proportional glyph variants.
  • 04Includes a FontForge-based patcher for applying the icons to your own font.
  • 05Installable through Homebrew, Chocolatey, Scoop, Arch packages, PowerShell or an install script.

Use cases

  • Showing icons in shell prompts such as Powerline-style prompts or Starship.
  • Displaying file-type and git icons in terminal file managers and editor file trees.
  • Patching a company or personal font so it includes icon glyphs for statusline plugins.

Quick start

  1. 1

    Download a font family archive from the releases page

  2. 2

    Install via Homebrew on macOS or Linux

    brew install font-hack-nerd-font
  3. 3

    Or use the install script to automate installation

Things to know

  • Licensing is listed as NOASSERTION in metadata, so check each bundled font's license before redistribution.
  • Patched fonts carry the licenses of their original upstream fonts, which vary by family.

Topics

FAQ

What is nerd-fonts?
Patches developer fonts such as Hack and Source Code Pro with thousands of icons from Font Awesome, Devicons, Octicons and other icon sets. Nerd Fonts takes popular programming fonts and adds a large set of glyphs (icons) drawn from popular iconic font collections such as Font Awesome, Devicons, Octicons, Material Design Icons and Powerline symbols. The result is a family of patched fonts that can display these icons directly in a terminal, editor or status line, which is useful for shell prompts, file-tree views and statusline plugins.
Is nerd-fonts free to use? What license does it have?
nerd-fonts is open source under the Other license. Check the license terms before using it in commercial products.
Is nerd-fonts still maintained?
Actively maintained. The last commit to nerd-fonts was on Oct 17, 2026.
What can I use nerd-fonts for?
Showing icons in shell prompts such as Powerline-style prompts or Starship. Displaying file-type and git icons in terminal file managers and editor file trees. Patching a company or personal font so it includes icon glyphs for statusline plugins.
How do I install nerd-fonts?
Download a font family archive from the releases page Install via Homebrew on macOS or Linux: brew install font-hack-nerd-font Or use the install script to automate installation
Where can I get nerd-fonts?
The source code and installation instructions are on GitHub: https://github.com/ryanoasis/nerd-fonts

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects