wezterm.nerdfonts

Since: 20220319-142410-0fcdea07

A special userdata value that can be used to resolve the symbolic name of a glyph from the Nerd Fonts font set into a string that can be used for example when formatting status lines and titles in your wezterm configuration.

WezTerm includes Nerd Font Symbols Font as a default font fallback which means that these special symbols are available even without requiring you to use a patched font.

This example shows how to lookup wezterm.nerdfonts.mdi_clock, the Material Design Icons glyph representing a clock, and use that together with the current date/time in the status area:

local wezterm = require 'wezterm'

wezterm.on('update-right-status', function(window, pane)
  -- "Wed Mar 3 08:14"
  local date = wezterm.strftime '%a %b %-d %H:%M '

  window:set_right_status(wezterm.format {
    { Text = wezterm.nerdfonts.mdi_clock .. ' ' .. date },
  })
end)

The following symbols are defined: