<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>docs/config/fonts.md - fork/wezterm @ termiz-0.23.2</title>
<meta name="description" content="docs/config/fonts.md in fork/wezterm at termiz-0.23.2.">
<meta property="og:title" content="docs/config/fonts.md - fork/wezterm @ termiz-0.23.2">
<meta property="og:description" content="docs/config/fonts.md in fork/wezterm at termiz-0.23.2.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="termiz-0.23.2" data-tip="8b7ca454b5e0a65b69b1b736db54eae3c195384b">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/wezterm</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/wezterm</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Wez Furlong</span><span class="commit-message" data-commit="0f8146b2120e2d747575f75831037a978d83435b">docs: shift from return {} style to config.something style</span><span class="snapshot-sha sha" data-commit="0f8146b2120e2d747575f75831037a978d83435b">0f8146b21</span><time datetime="2023-03-19T18:26:21-07:00" title="2023-03-19 18:26:21 -0700">2023-03-19</time></p>
<header class="topbar"><details class="switcher"><summary>termiz-0.23.2</summary><div class="menu"><strong>branches</strong><a href="/fork/wezterm/ref/main/">main</a><strong>tags</strong><a href="/fork/wezterm/ref/termiz-0.23.1/">termiz-0.23.1</a><a class="current" href="/fork/wezterm/ref/termiz-0.23.2/">termiz-0.23.2</a><a href="/fork/wezterm/ref/termiz-0.23.3/">termiz-0.23.3</a><a href="/fork/wezterm/ref/termwiz-0.23.0/">termwiz-0.23.0</a><a href="/fork/wezterm/ref/termwiz-0.23.1/">termwiz-0.23.1</a><a href="/fork/wezterm/ref/termwiz-0.23.2/">termwiz-0.23.2</a><a href="/fork/wezterm/ref/termwiz-0.23.3/">termwiz-0.23.3</a><a href="/fork/wezterm/ref/vtparse-0.7.0/">vtparse-0.7.0</a><a class="all" href="/fork/wezterm/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/wezterm/">wezterm</a> / <a href="/fork/wezterm/ref/termiz-0.23.2/tree/docs/">docs</a> / <a href="/fork/wezterm/ref/termiz-0.23.2/tree/docs/config/">config</a> / <span class="cur">fonts.md</span></nav>
<span class="view-stats"><span>8.2 KiB</span><span>156 lines</span></span><span class="actions"><a class="raw" href="/fork/wezterm/raw/7d5846907122e0829914144fad94a1903a03ac14/docs/config/fonts.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><h3>Font Related Configuration</h3>
<p>WezTerm bundles <a href="https://www.jetbrains.com/lp/mono/">JetBrains Mono</a>,
<a href="https://nerdfonts.com">Nerd Font Symbols</a> and
<a href="https://www.google.com/get/noto/help/emoji/">Noto Color Emoji</a> fonts
and uses those for the default font configuration.</p>
<p>If you wish to use a different font face, then you can use
the <a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/wezterm/font.md">wezterm.font</a> function to specify it:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>font</a-v> = <a-v>wezterm</a-v><a-p>.</a-p><a-f>font</a-f> <a-s>&#39;Fira Code&#39;</a-s>
<a-c>-- You can specify some parameters to influence the font selection;</a-c>
<a-c>-- for example, this selects a Bold, Italic font variant.</a-c>
<a-v>config</a-v><a-p>.</a-p><a-v>font</a-v> =
  <a-v>wezterm</a-v><a-p>.</a-p><a-f>font</a-f><a-p>(</a-p><a-s>&#39;JetBrains Mono&#39;</a-s><a-p>,</a-p> <a-cr>{</a-cr> <a-v>weight</a-v> = <a-s>&#39;Bold&#39;</a-s><a-p>,</a-p> <a-v>italic</a-v> = <a-co>true</a-co> <a-cr>}</a-cr><a-p>)</a-p></pre>
<h4>Fallback</h4>
<p>WezTerm allows specifying an ordered list of fonts; when resolving
text into glyphs the first font in the list is consulted, and if the
glyph isn't present in that font, WezTerm proceeds to the next font
in the fallback list.</p>
<p>The default fallback includes the popular <a href="https://nerdfonts.com">Nerd Font
Symbols</a> font, which means that you don't need to use
specially patched fonts to use the powerline or Nerd Fonts symbol glyphs.</p>
<p>You can specify your own fallback; that's useful if you've got a killer
monospace font, but it doesn't have glyphs for the asian script that you
sometimes work with:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>font</a-v> = <a-v>wezterm</a-v><a-p>.</a-p><a-f>font_with_fallback</a-f> <a-cr>{</a-cr>
  <a-s>&#39;Fira Code&#39;</a-s><a-p>,</a-p>
  <a-s>&#39;DengXian&#39;</a-s><a-p>,</a-p>
<a-cr>}</a-cr></pre>
<p>WezTerm will still append its default fallback to whatever list you specify,
so you needn't worry about replicating that list if you set your own fallback.</p>
<p>If none of the fonts in the fallback list (including WezTerm's default fallback
list) contain a given glyph, then wezterm will resolve the system fallback list
and try those fonts too.  If a glyph cannot be resolved, wezterm will render a
special "Last Resort" glyph as a placeholder.  You may notice the placeholder
appear momentarily and then refresh itself to the system fallback glyph on some
systems.</p>
<h3>Font Related Options</h3>
<p>Additional options for configuring fonts can be found elsewhere in the docs:</p>
<ul>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/bold_brightens_ansi_colors.md">bold_brightens_ansi_colors</a> - whether bold text uses the bright ansi palette</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/dpi.md">dpi</a> - override the DPI; potentially useful for X11 users with high-density displays if experiencing tiny or blurry fonts</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/font_dirs.md">font_dirs</a> - look for fonts in a set of directories</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/font_locator.md">font_locator</a> - override the system font resolver</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/font_rules.md">font_rules</a> - advanced control over which fonts are used for italic, bold and other textual styles</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/font_shaper.md">font_shaper</a> - affects kerning and ligatures</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/font_size.md">font_size</a> - change the size of the text</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/freetype_load_flags.md">freetype_load_flags</a> - advanced hinting configuration</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/freetype_load_target.md">freetype_load_target</a> - configure hinting and anti-aliasing</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/freetype_render_target.md">freetype_render_target</a> - configure anti-aliasing</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/cell_width.md">cell_width</a> - scale the font-specified cell width</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/config/line_height.md">line_height</a> - scale the font-specified line height</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/wezterm/font.md">wezterm.font</a> - select a font based on family and style attributes</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.2/blob/docs/config/lua/wezterm/font_with_fallback.md">wezterm.font_with_fallback</a> - select a font from a list of candidates</li>
</ul>
<h2>Troubleshooting Fonts</h2>
<p>You may use <code>wezterm ls-fonts</code> to have wezterm explain information about which font files it will use for the different text styles.</p>
<p>It shows output like this:</p>
<pre class="language-bash"><a-o>$</a-o><a-f> </a-f><a-pr>wezterm</a-pr> ls-fonts
<a-f>Primary</a-f> font:
<a-f>wezterm.font_with_fallback</a-f>({
  <a-co>--</a-co> /home/wez/.fonts/OperatorMonoSSmLig-Medium.otf, FontDirs
  {<a-pr>family</a-pr>=<a-s>&quot;Operator Mono SSm Lig&quot;</a-s>, <a-pr>weight</a-pr>=<a-s>&quot;DemiLight&quot;</a-s>},

  <a-co>--</a-co> /home/wez/.fonts/MaterialDesignIconsDesktop.ttf, FontDirs
  <a-s>&quot;Material Design Icons Desktop&quot;</a-s><a-f>,</a-f>

  <a-co>--</a-co> /usr/share/fonts/jetbrains-mono-fonts/JetBrainsMono-Regular.ttf, FontConfig
  <a-s>&quot;JetBrains Mono&quot;</a-s><a-f>,</a-f>

  <a-co>--</a-co> /usr/share/fonts/google-noto-emoji/NotoColorEmoji.ttf, FontConfig
  <a-co>--</a-co> Assumed to have Emoji Presentation
  <a-co>--</a-co> Pixel sizes: [128]
  <a-s>&quot;Noto Color Emoji&quot;</a-s><a-f>,</a-f>
})


<a-f>When</a-f> Intensity=Half Italic=true:
<a-f>wezterm.font_with_fallback</a-f>({
  <a-co>--</a-co> /home/wez/.fonts/OperatorMonoSSmLig-BookItalic.otf, FontDirs
  {<a-pr>family</a-pr>=<a-s>&quot;Operator Mono SSm Lig&quot;</a-s>, <a-pr>weight</a-pr>=325, <a-pr>italic</a-pr>=true},

  <a-co>--</a-co> /home/wez/.fonts/MaterialDesignIconsDesktop.ttf, FontDirs
  <a-s>&quot;Material Design Icons Desktop&quot;</a-s><a-f>,</a-f>

  <a-co>--</a-co> /usr/share/fonts/jetbrains-mono-fonts/JetBrainsMono-Regular.ttf, FontConfig
  <a-s>&quot;JetBrains Mono&quot;</a-s><a-f>,</a-f>

  <a-co>--</a-co> /usr/share/fonts/google-noto-emoji/NotoColorEmoji.ttf, FontConfig
  <a-co>--</a-co> Assumed to have Emoji Presentation
  <a-co>--</a-co> Pixel sizes: [128]
  <a-s>&quot;Noto Color Emoji&quot;</a-s><a-f>,</a-f>
})
...</pre>
<p>You can ask wezterm to including a listing of all of the fonts on the system in a form that can be copied and pasted into the configuration file:</p>
<pre class="language-bash"><a-o>$</a-o><a-f> </a-f><a-pr>wezterm</a-pr> ls-fonts <a-co>--list-system</a-co>
<a-o>&lt;</a-o>same <a-f>output</a-f> as above, but then:<a-o>&gt;</a-o>
112 fonts found in your font_dirs + built-in fonts:
<a-f>wezterm.font</a-f>(<a-s>&quot;Cascadia Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;ExtraLight&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/CascadiaCode.ttf</a-f> index=0 variation=1, FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Cascadia Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Light&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/CascadiaCode.ttf</a-f> index=0 variation=2, FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Cascadia Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;DemiLight&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/CascadiaCode.ttf</a-f> index=0 variation=3, FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Cascadia Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Regular&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/CascadiaCode.ttf</a-f> index=0 variation=4, FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Cascadia Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;DemiBold&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/CascadiaCode.ttf</a-f> index=0 variation=5, FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Cascadia Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Bold&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/CascadiaCode.ttf</a-f> index=0 variation=6, FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Fira Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Light&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/FiraCode-Light.otf,</a-f> FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Fira Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Regular&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/FiraCode-Regular.otf,</a-f> FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Fira Code&quot;</a-s><a-f>,</a-f> {weight=450, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/FiraCode-Retina.otf,</a-f> FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Fira Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Medium&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/FiraCode-Medium.otf,</a-f> FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Fira Code&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Bold&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/FiraCode-Bold.otf,</a-f> FontDirs
<a-f>wezterm.font</a-f>(<a-s>&quot;Font Awesome 5 Free&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Black&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/home/wez/.fonts/Font</a-f> Awesome 5 Free-Solid-900.otf, FontDirs
<a-f>...</a-f>
<a-f>690</a-f> system fonts found using FontConfig:
<a-f>wezterm.font</a-f>(<a-s>&quot;Abyssinica SIL&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Regular&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/usr/share/fonts/sil-abyssinica-fonts/AbyssinicaSIL-R.ttf,</a-f> FontConfig
<a-f>wezterm.font</a-f>(<a-s>&quot;C059&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Regular&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/usr/share/fonts/urw-base35/C059-Bold.t1,</a-f> FontConfig
<a-f>wezterm.font</a-f>(<a-s>&quot;C059&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Regular&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/usr/share/fonts/urw-base35/C059-Roman.otf,</a-f> FontConfig
<a-f>wezterm.font</a-f>(<a-s>&quot;C059&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Regular&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false}) -- <a-f>/usr/share/fonts/urw-base35/C059-Roman.t1,</a-f> FontConfig
<a-f>wezterm.font</a-f>(<a-s>&quot;C059&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Regular&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=true}) -- <a-f>/usr/share/fonts/urw-base35/C059-BdIta.t1,</a-f> FontConfig
<a-f>wezterm.font</a-f>(<a-s>&quot;C059&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Regular&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=true}) -- <a-f>/usr/share/fonts/urw-base35/C059-Italic.otf,</a-f> FontConfig
<a-f>...</a-f></pre>
<p>You may also display the shaping plan for a given text string; in this example,
the <code>a</code> and the <code>b</code> are separated by a special symbol which is not present in
the main font, so we expect to see a different font used for that glyph:</p>
<pre class="language-bash"><a-o>$</a-o><a-f> </a-f><a-pr>wezterm</a-pr> ls-fonts <a-co>--text</a-co> a🞄b
<a-f>a</a-f>    \u{61}       x_adv=8  glyph=29   wezterm.font(<a-s>&quot;Operator Mono SSm Lig&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;DemiLight&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false})
                                      <a-f>/home/wez/.fonts/OperatorMonoSSmLig-Medium.otf,</a-f> FontDirs
<a-f>🞄</a-f>    \u{1f784}    x_adv=4  glyph=9129 wezterm.font(<a-s>&quot;Symbola&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;Regular&quot;</a-s>, stretch=<a-s>&quot;SemiCondensed&quot;</a-s>, italic=false})
                                      <a-f>/usr/share/fonts/gdouros-symbola/Symbola.ttf,</a-f> FontConfig
<a-f>b</a-f>    \u{62}       x_adv=8  glyph=30   wezterm.font(<a-s>&quot;Operator Mono SSm Lig&quot;</a-s><a-f>,</a-f> {weight=<a-s>&quot;DemiLight&quot;</a-s>, stretch=<a-s>&quot;Normal&quot;</a-s>, italic=false})
                                      <a-f>/home/wez/.fonts/OperatorMonoSSmLig-Medium.otf,</a-f> FontDirs</pre>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>###</a-p> <a-tt>Font Related Configuration</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text">WezTerm bundles [JetBrains Mono](https://www.jetbrains.com/lp/mono/),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text">[Nerd Font Symbols](https://nerdfonts.com) and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">[Noto Color Emoji](https://www.google.com/get/noto/help/emoji/) fonts</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text">and uses those for the default font configuration.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text">If you wish to use a different font face, then you can use</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text">the [wezterm.font](lua/wezterm/font.md) function to specify it:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>```</a-p><a-tl>lua</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"><a-p>config.</a-p><a-v>font</a-v><a-p> = </a-p><a-v>wezterm</a-v><a-p>.</a-p><a-f>font</a-f><a-p> </a-p><a-s>&#39;Fira Code&#39;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"><a-p>-- You can specify some parameters to influence the font selection;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"><a-p>-- for example, this selects a Bold, Italic font variant.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>config.</a-p><a-v>font</a-v><a-p> =</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"><a-p>  </a-p><a-v>wezterm</a-v><a-p>.</a-p><a-f>font</a-f><a-p>(</a-p><a-s>&#39;JetBrains Mono&#39;</a-s><a-p>, </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>weight</a-v><a-p> = </a-p><a-s>&#39;Bold&#39;</a-s><a-p>, </a-p><a-v>italic</a-v><a-p> = </a-p><a-co>true</a-co><a-p> </a-p><a-cr>}</a-cr><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>#### </a-p><a-tt>Fallback</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>WezTerm allows specifying an ordered list of fonts; when resolving</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>text into glyphs the first font in the list is consulted, and if the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p>glyph isn&#39;t present in that font, WezTerm proceeds to the next font</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>in the fallback list.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>The default fallback includes the popular [Nerd Font</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-p>Symbols](https://nerdfonts.com) font, which means that you don&#39;t need to use</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>specially patched fonts to use the powerline or Nerd Fonts symbol glyphs.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>You can specify your own fallback; that&#39;s useful if you&#39;ve got a killer</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"><a-p>monospace font, but it doesn&#39;t have glyphs for the asian script that you</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>sometimes work with:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>```</a-p><a-tl>lua</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>config.</a-p><a-v>font</a-v><a-p> = </a-p><a-v>wezterm</a-v><a-p>.</a-p><a-f>font_with_fallback</a-f><a-p> </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>  </a-p><a-s>&#39;Fira Code&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>  </a-p><a-s>&#39;DengXian&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>WezTerm will still append its default fallback to whatever list you specify,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>so you needn&#39;t worry about replicating that list if you set your own fallback.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>If none of the fonts in the fallback list (including WezTerm&#39;s default fallback</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>list) contain a given glyph, then wezterm will resolve the system fallback list</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>and try those fonts too.  If a glyph cannot be resolved, wezterm will render a</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"><a-p>special &quot;Last Resort&quot; glyph as a placeholder.  You may notice the placeholder</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>appear momentarily and then refresh itself to the system fallback glyph on some</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>systems.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>### </a-p><a-tt>Font Related Options</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>Additional options for configuring fonts can be found elsewhere in the docs:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>* [bold_brightens_ansi_colors](lua/config/bold_brightens_ansi_colors.md) - whether bold text uses the bright ansi palette</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>* [dpi](lua/config/dpi.md) - override the DPI; potentially useful for X11 users with high-density displays if experiencing tiny or blurry fonts</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"><a-p>* [font_dirs](lua/config/font_dirs.md) - look for fonts in a set of directories</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>* [font_locator](lua/config/font_locator.md) - override the system font resolver</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>* [font_rules](lua/config/font_rules.md) - advanced control over which fonts are used for italic, bold and other textual styles</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"><a-p>* [font_shaper](lua/config/font_shaper.md) - affects kerning and ligatures</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>* [font_size](lua/config/font_size.md) - change the size of the text</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>* [freetype_load_flags](lua/config/freetype_load_flags.md) - advanced hinting configuration</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>* [freetype_load_target](lua/config/freetype_load_target.md) - configure hinting and anti-aliasing</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>* [freetype_render_target](lua/config/freetype_render_target.md) - configure anti-aliasing</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>* [cell_width](lua/config/cell_width.md) - scale the font-specified cell width</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>* [line_height](lua/config/line_height.md) - scale the font-specified line height</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-p>* [wezterm.font](lua/wezterm/font.md) - select a font based on family and style attributes</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"><a-p>* [wezterm.font_with_fallback](lua/wezterm/font_with_fallback.md) - select a font from a list of candidates</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>## </a-p><a-tt>Troubleshooting Fonts</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"><a-p>You may use `wezterm ls-fonts` to have wezterm explain information about which font files it will use for the different text styles.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"><a-p>It shows output like this:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"><a-p>```</a-p><a-tl>console</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"><a-p>$ wezterm ls-fonts</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"><a-p>Primary font:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"><a-p>wezterm.font_with_fallback({</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"><a-p>  -- /home/wez/.fonts/OperatorMonoSSmLig-Medium.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"><a-p>  {family=&quot;Operator Mono SSm Lig&quot;, weight=&quot;DemiLight&quot;},</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"><a-p>  -- /home/wez/.fonts/MaterialDesignIconsDesktop.ttf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"><a-p>  &quot;Material Design Icons Desktop&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>  -- /usr/share/fonts/jetbrains-mono-fonts/JetBrainsMono-Regular.ttf, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"><a-p>  &quot;JetBrains Mono&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"><a-p>  -- /usr/share/fonts/google-noto-emoji/NotoColorEmoji.ttf, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>  -- Assumed to have Emoji Presentation</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"><a-p>  -- Pixel sizes: [128]</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text"><a-p>  &quot;Noto Color Emoji&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"><a-p>})</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"><a-p>When Intensity=Half Italic=true:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"><a-p>wezterm.font_with_fallback({</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"><a-p>  -- /home/wez/.fonts/OperatorMonoSSmLig-BookItalic.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"><a-p>  {family=&quot;Operator Mono SSm Lig&quot;, weight=325, italic=true},</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"><a-p>  -- /home/wez/.fonts/MaterialDesignIconsDesktop.ttf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"><a-p>  &quot;Material Design Icons Desktop&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"><a-p>  -- /usr/share/fonts/jetbrains-mono-fonts/JetBrainsMono-Regular.ttf, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text"><a-p>  &quot;JetBrains Mono&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"><a-p>  -- /usr/share/fonts/google-noto-emoji/NotoColorEmoji.ttf, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text"><a-p>  -- Assumed to have Emoji Presentation</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text"><a-p>  -- Pixel sizes: [128]</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text"><a-p>  &quot;Noto Color Emoji&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text"><a-p>})</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text"><a-p>...</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text"><a-p>You can ask wezterm to including a listing of all of the fonts on the system in a form that can be copied and pasted into the configuration file:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text"><a-p>```</a-p><a-tl>console</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text"><a-p>$ wezterm ls-fonts --list-system</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L119" href="#L119">119</a><span class="code-text"><a-p>&lt;same output as above, but then:&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L120" href="#L120">120</a><span class="code-text"><a-p>112 fonts found in your font_dirs + built-in fonts:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text"><a-p>wezterm.font(&quot;Cascadia Code&quot;, {weight=&quot;ExtraLight&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/CascadiaCode.ttf index=0 variation=1, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text"><a-p>wezterm.font(&quot;Cascadia Code&quot;, {weight=&quot;Light&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/CascadiaCode.ttf index=0 variation=2, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L123" href="#L123">123</a><span class="code-text"><a-p>wezterm.font(&quot;Cascadia Code&quot;, {weight=&quot;DemiLight&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/CascadiaCode.ttf index=0 variation=3, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L124" href="#L124">124</a><span class="code-text"><a-p>wezterm.font(&quot;Cascadia Code&quot;, {weight=&quot;Regular&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/CascadiaCode.ttf index=0 variation=4, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L125" href="#L125">125</a><span class="code-text"><a-p>wezterm.font(&quot;Cascadia Code&quot;, {weight=&quot;DemiBold&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/CascadiaCode.ttf index=0 variation=5, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L126" href="#L126">126</a><span class="code-text"><a-p>wezterm.font(&quot;Cascadia Code&quot;, {weight=&quot;Bold&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/CascadiaCode.ttf index=0 variation=6, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L127" href="#L127">127</a><span class="code-text"><a-p>wezterm.font(&quot;Fira Code&quot;, {weight=&quot;Light&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/FiraCode-Light.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L128" href="#L128">128</a><span class="code-text"><a-p>wezterm.font(&quot;Fira Code&quot;, {weight=&quot;Regular&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/FiraCode-Regular.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text"><a-p>wezterm.font(&quot;Fira Code&quot;, {weight=450, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/FiraCode-Retina.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text"><a-p>wezterm.font(&quot;Fira Code&quot;, {weight=&quot;Medium&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/FiraCode-Medium.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L131" href="#L131">131</a><span class="code-text"><a-p>wezterm.font(&quot;Fira Code&quot;, {weight=&quot;Bold&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/FiraCode-Bold.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L132" href="#L132">132</a><span class="code-text"><a-p>wezterm.font(&quot;Font Awesome 5 Free&quot;, {weight=&quot;Black&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /home/wez/.fonts/Font Awesome 5 Free-Solid-900.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L133" href="#L133">133</a><span class="code-text"><a-p>...</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L134" href="#L134">134</a><span class="code-text"><a-p>690 system fonts found using FontConfig:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L135" href="#L135">135</a><span class="code-text"><a-p>wezterm.font(&quot;Abyssinica SIL&quot;, {weight=&quot;Regular&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /usr/share/fonts/sil-abyssinica-fonts/AbyssinicaSIL-R.ttf, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L136" href="#L136">136</a><span class="code-text"><a-p>wezterm.font(&quot;C059&quot;, {weight=&quot;Regular&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /usr/share/fonts/urw-base35/C059-Bold.t1, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L137" href="#L137">137</a><span class="code-text"><a-p>wezterm.font(&quot;C059&quot;, {weight=&quot;Regular&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /usr/share/fonts/urw-base35/C059-Roman.otf, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L138" href="#L138">138</a><span class="code-text"><a-p>wezterm.font(&quot;C059&quot;, {weight=&quot;Regular&quot;, stretch=&quot;Normal&quot;, italic=false}) -- /usr/share/fonts/urw-base35/C059-Roman.t1, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L139" href="#L139">139</a><span class="code-text"><a-p>wezterm.font(&quot;C059&quot;, {weight=&quot;Regular&quot;, stretch=&quot;Normal&quot;, italic=true}) -- /usr/share/fonts/urw-base35/C059-BdIta.t1, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L140" href="#L140">140</a><span class="code-text"><a-p>wezterm.font(&quot;C059&quot;, {weight=&quot;Regular&quot;, stretch=&quot;Normal&quot;, italic=true}) -- /usr/share/fonts/urw-base35/C059-Italic.otf, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L141" href="#L141">141</a><span class="code-text"><a-p>...</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L144" href="#L144">144</a><span class="code-text"><a-p>You may also display the shaping plan for a given text string; in this example,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L145" href="#L145">145</a><span class="code-text"><a-p>the `a` and the `b` are separated by a special symbol which is not present in</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L146" href="#L146">146</a><span class="code-text"><a-p>the main font, so we expect to see a different font used for that glyph:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L148" href="#L148">148</a><span class="code-text"><a-p>```</a-p><a-tl>console</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L149" href="#L149">149</a><span class="code-text"><a-p>$ wezterm ls-fonts --text a🞄b</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L150" href="#L150">150</a><span class="code-text"><a-p>a    \u{61}       x_adv=8  glyph=29   wezterm.font(&quot;Operator Mono SSm Lig&quot;, {weight=&quot;DemiLight&quot;, stretch=&quot;Normal&quot;, italic=false})</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L151" href="#L151">151</a><span class="code-text"><a-p>                                      /home/wez/.fonts/OperatorMonoSSmLig-Medium.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L152" href="#L152">152</a><span class="code-text"><a-p>🞄    \u{1f784}    x_adv=4  glyph=9129 wezterm.font(&quot;Symbola&quot;, {weight=&quot;Regular&quot;, stretch=&quot;SemiCondensed&quot;, italic=false})</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L153" href="#L153">153</a><span class="code-text"><a-p>                                      /usr/share/fonts/gdouros-symbola/Symbola.ttf, FontConfig</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L154" href="#L154">154</a><span class="code-text"><a-p>b    \u{62}       x_adv=8  glyph=30   wezterm.font(&quot;Operator Mono SSm Lig&quot;, {weight=&quot;DemiLight&quot;, stretch=&quot;Normal&quot;, italic=false})</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L155" href="#L155">155</a><span class="code-text"><a-p>                                      /home/wez/.fonts/OperatorMonoSSmLig-Medium.otf, FontDirs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L156" href="#L156">156</a><span class="code-text"><a-p>```</a-p></span></span></pre></div></div>
</main>
</body>
</html>
