<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>docs/config/appearance.md - fork/wezterm @ termiz-0.23.3</title>
<meta name="description" content="docs/config/appearance.md in fork/wezterm at termiz-0.23.3.">
<meta property="og:title" content="docs/config/appearance.md - fork/wezterm @ termiz-0.23.3">
<meta property="og:description" content="docs/config/appearance.md in fork/wezterm at termiz-0.23.3.">
<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.3" data-tip="4bf28e253c0167102f07bfc7e7199c13eed98012">
<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">mgpinf</span><span class="commit-message" data-commit="413ebd5681f443676f09841f269412af1cec3aee">Add configuration option for InputSelector label background and foreground color (#6682)</span><span class="snapshot-sha sha" data-commit="413ebd5681f443676f09841f269412af1cec3aee">413ebd568</span><time datetime="2025-03-09T16:59:13+05:30" title="2025-03-09 16:59:13 +0530">2025-03-09</time></p>
<header class="topbar"><details class="switcher"><summary>termiz-0.23.3</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 href="/fork/wezterm/ref/termiz-0.23.2/">termiz-0.23.2</a><a class="current" 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.3/tree/docs/">docs</a> / <a href="/fork/wezterm/ref/termiz-0.23.3/tree/docs/config/">config</a> / <span class="cur">appearance.md</span></nav>
<span class="view-stats"><span>17.6 KiB</span><span>548 lines</span></span><span class="actions"><a class="raw" href="/fork/wezterm/raw/3093910d276e459bb3c97917fb9145aeffe8e220/docs/config/appearance.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>Color Scheme</h3>
<p>WezTerm ships with over 700 color schemes available from
<a href="https://github.com/mbadolato/iTerm2-Color-Schemes#screenshots">iTerm2-Color-Schemes</a>,
<a href="https://github.com/chriskempson/base16-schemes-source">base16</a>,
<a href="https://gogh-co.github.io/Gogh/">Gogh</a> and
<a href="https://terminal.sexy/">terminal.sexy</a> and a couple of other locations.</p>
<p>You can select a color scheme with a line like this:</p>
<pre class="language-lua"><a-k>local</a-k> <a-v>wezterm</a-v> = <a-f>require</a-f> <a-s>&#39;wezterm&#39;</a-s>
<a-k>local</a-k> <a-v>config</a-v> = <a-cr>{}</a-cr>

<a-v>config</a-v><a-p>.</a-p><a-v>color_scheme</a-v> = <a-s>&#39;Batman&#39;</a-s>

<a-k>return</a-k> <a-v>config</a-v></pre>
<p>You can find a list of available color schemes and screenshots
in <a href="../colorschemes/index.md">The Color Schemes Section</a>.</p>
<p>If you'd like to automatically adjust your color scheme based on the
system dark mode or light mode appearance, see the example in
<a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/wezterm.gui/get_appearance.md">wezterm.gui.get_appearance()</a></p>
<p>!!! note
if you are using multiplexing with ssh or tls domains, the color scheme
is controlled by the config file on the multiplexer server side. This is
because the palette is an attribute of the terminal emulation and that state
lives on the multiplexer server.*</p>
<h3>Precedence of <code>colors</code> vs <code>color_schemes</code></h3>
<p>The <code>color_scheme</code> option takes precedence over the <code>colors</code> section below,
and is mutually exclusive with it. If you want to merge/override colors
you need to use <a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/wezterm.color/get_default_colors.md">wezterm.color.get_default_colors()</a> and explicitly merge them.</p>
<p>{{since('20220903-194523-3bb1ed61')}}</p>
<p>The behavior has been changed so that the <code>color_scheme</code> you have selected, if
any, is used to define the colors, and then any colors you define in the
<code>colors</code> section will override those colors.</p>
<h3>Defining your own colors</h3>
<p>You can specify the color palette using the <code>colors</code> configuration section.</p>
<p>You can configure colors with a section like this.  In addition to specifying
<a href="https://docs.rs/palette/0.4.1/palette/named/index.html#constants">SVG/CSS3 color names</a>,
you can use <code>#RRGGBB</code> to specify a color code using the
usual hex notation; eg: <code>#000000</code> is equivalent to <code>black</code>:</p>
<pre class="language-lua"><a-k>local</a-k> <a-v>wezterm</a-v> = <a-f>require</a-f> <a-s>&#39;wezterm&#39;</a-s>
<a-k>local</a-k> <a-v>config</a-v> = <a-cr>{}</a-cr>

<a-v>config</a-v><a-p>.</a-p><a-v>colors</a-v> = <a-cr>{</a-cr>
  <a-c>-- The default text color</a-c>
  <a-v>foreground</a-v> = <a-s>&#39;silver&#39;</a-s><a-p>,</a-p>
  <a-c>-- The default background color</a-c>
  <a-v>background</a-v> = <a-s>&#39;black&#39;</a-s><a-p>,</a-p>

  <a-c>-- Overrides the cell background color when the current cell is occupied by the</a-c>
  <a-c>-- cursor and the cursor style is set to Block</a-c>
  <a-v>cursor_bg</a-v> = <a-s>&#39;#52ad70&#39;</a-s><a-p>,</a-p>
  <a-c>-- Overrides the text color when the current cell is occupied by the cursor</a-c>
  <a-v>cursor_fg</a-v> = <a-s>&#39;black&#39;</a-s><a-p>,</a-p>
  <a-c>-- Specifies the border color of the cursor when the cursor style is set to Block,</a-c>
  <a-c>-- or the color of the vertical or horizontal bar when the cursor style is set to</a-c>
  <a-c>-- Bar or Underline.</a-c>
  <a-v>cursor_border</a-v> = <a-s>&#39;#52ad70&#39;</a-s><a-p>,</a-p>

  <a-c>-- the foreground color of selected text</a-c>
  <a-v>selection_fg</a-v> = <a-s>&#39;black&#39;</a-s><a-p>,</a-p>
  <a-c>-- the background color of selected text</a-c>
  <a-v>selection_bg</a-v> = <a-s>&#39;#fffacd&#39;</a-s><a-p>,</a-p>

  <a-c>-- The color of the scrollbar &quot;thumb&quot;; the portion that represents the current viewport</a-c>
  <a-v>scrollbar_thumb</a-v> = <a-s>&#39;#222222&#39;</a-s><a-p>,</a-p>

  <a-c>-- The color of the split lines between panes</a-c>
  <a-v>split</a-v> = <a-s>&#39;#444444&#39;</a-s><a-p>,</a-p>

  <a-v>ansi</a-v> = <a-cr>{</a-cr>
    <a-s>&#39;black&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;maroon&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;green&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;olive&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;navy&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;purple&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;teal&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;silver&#39;</a-s><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>
  <a-v>brights</a-v> = <a-cr>{</a-cr>
    <a-s>&#39;grey&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;red&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;lime&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;yellow&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;blue&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;fuchsia&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;aqua&#39;</a-s><a-p>,</a-p>
    <a-s>&#39;white&#39;</a-s><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>

  <a-c>-- Arbitrary colors of the palette in the range from 16 to 255</a-c>
  <a-v>indexed</a-v> = <a-cr>{</a-cr> <a-p>[</a-p><a-n>136</a-n><a-p>]</a-p> = <a-s>&#39;#af8700&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>

  <a-c>-- Since: 20220319-142410-0fcdea07</a-c>
  <a-c>-- When the IME, a dead key or a leader key are being processed and are effectively</a-c>
  <a-c>-- holding input pending the result of input composition, change the cursor</a-c>
  <a-c>-- to this color to give a visual cue about the compose state.</a-c>
  <a-v>compose_cursor</a-v> = <a-s>&#39;orange&#39;</a-s><a-p>,</a-p>

  <a-c>-- Colors for copy_mode and quick_select</a-c>
  <a-c>-- available since: 20220807-113146-c2fee766</a-c>
  <a-c>-- In copy_mode, the color of the active text is:</a-c>
  <a-c>-- 1. copy_mode_active_highlight_* if additional text was selected using the mouse</a-c>
  <a-c>-- 2. selection_* otherwise</a-c>
  <a-v>copy_mode_active_highlight_bg</a-v> = <a-cr>{</a-cr> <a-v>Color</a-v> = <a-s>&#39;#000000&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
  <a-c>-- use `AnsiColor` to specify one of the ansi color palette values</a-c>
  <a-c>-- (index 0-15) using one of the names &quot;Black&quot;, &quot;Maroon&quot;, &quot;Green&quot;,</a-c>
  <a-c>--  &quot;Olive&quot;, &quot;Navy&quot;, &quot;Purple&quot;, &quot;Teal&quot;, &quot;Silver&quot;, &quot;Grey&quot;, &quot;Red&quot;, &quot;Lime&quot;,</a-c>
  <a-c>-- &quot;Yellow&quot;, &quot;Blue&quot;, &quot;Fuchsia&quot;, &quot;Aqua&quot; or &quot;White&quot;.</a-c>
  <a-v>copy_mode_active_highlight_fg</a-v> = <a-cr>{</a-cr> <a-v>AnsiColor</a-v> = <a-s>&#39;Black&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
  <a-v>copy_mode_inactive_highlight_bg</a-v> = <a-cr>{</a-cr> <a-v>Color</a-v> = <a-s>&#39;#52ad70&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
  <a-v>copy_mode_inactive_highlight_fg</a-v> = <a-cr>{</a-cr> <a-v>AnsiColor</a-v> = <a-s>&#39;White&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>

  <a-v>quick_select_label_bg</a-v> = <a-cr>{</a-cr> <a-v>Color</a-v> = <a-s>&#39;peru&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
  <a-v>quick_select_label_fg</a-v> = <a-cr>{</a-cr> <a-v>Color</a-v> = <a-s>&#39;#ffffff&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
  <a-v>quick_select_match_bg</a-v> = <a-cr>{</a-cr> <a-v>AnsiColor</a-v> = <a-s>&#39;Navy&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>
  <a-v>quick_select_match_fg</a-v> = <a-cr>{</a-cr> <a-v>Color</a-v> = <a-s>&#39;#ffffff&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>

  <a-v>input_selector_label_bg</a-v> = <a-cr>{</a-cr> <a-v>AnsiColor</a-v> = <a-s>&#39;Black&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p> <a-c>-- {{since(&#39;nightly&#39;, inline=True)}}</a-c>
  <a-v>input_selector_label_fg</a-v> = <a-cr>{</a-cr> <a-v>Color</a-v> = <a-s>&#39;#ffffff&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p> <a-c>-- {{since(&#39;nightly&#39;, inline=True)}}</a-c>
<a-cr>}</a-cr>

<a-k>return</a-k> <a-v>config</a-v></pre>
<p>{{since('20220101-133340-7edc5b5a')}}</p>
<p>You may specify colors in the HSL color space, if you prefer that over RGB, by using:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>colors</a-v> = <a-cr>{</a-cr>
  <a-c>-- the first number is the hue measured in degrees with a range</a-c>
  <a-c>-- of 0-360.</a-c>
  <a-c>-- The second number is the saturation measured in percentage with</a-c>
  <a-c>-- a range of 0-100.</a-c>
  <a-c>-- The third number is the lightness measured in percentage with</a-c>
  <a-c>-- a range of 0-100.</a-c>
  <a-v>foreground</a-v> = <a-s>&#39;hsl:235 100 50&#39;</a-s><a-p>,</a-p>
<a-cr>}</a-cr></pre>
<p>{{since('20220319-142410-0fcdea07')}}</p>
<p>Colors now also accept the following CSS-style color specifications:</p>
<pre>rgb(0,255,0)
rgb(0% 100% 0%)
rgb(0 255 0 / 100%)
rgba(0,255,0,1)
hsl(120,100%,50%)
hsl(120deg 100% 50%)
hsl(-240 100% 50%)
hsl(-240deg 100% 50%)
hsl(0.3333turn 100% 50%)
hsl(133.333grad 100% 50%)
hsl(2.0944rad 100% 50%)
hsla(120,100%,50%,100%)
hwb(120 0% 0%)
hwb(480deg 0% 0% / 100%)
hsv(120,100%,100%)
hsv(120deg 100% 100% / 100%)
</pre>
<p>The alpha value is ignored except when used with <code>selection_fg</code> and
<code>selection_bg</code>:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>colors</a-v> = <a-cr>{</a-cr>
  <a-c>-- Make the selection text color fully transparent.</a-c>
  <a-c>-- When fully transparent, the current text color will be used.</a-c>
  <a-v>selection_fg</a-v> = <a-s>&#39;none&#39;</a-s><a-p>,</a-p>
  <a-c>-- Set the selection background color with alpha.</a-c>
  <a-c>-- When selection_bg is transparent, it will be alpha blended over</a-c>
  <a-c>-- the current cell background color, rather than replace it</a-c>
  <a-v>selection_bg</a-v> = <a-s>&#39;rgba(50% 50% 50% 50%)&#39;</a-s><a-p>,</a-p>
<a-cr>}</a-cr></pre>
<h3>Defining a Color Scheme in your <code>.wezterm.lua</code></h3>
<p>If you'd like to keep a couple of color schemes handy in your configuration
file, rather than filling out the <code>colors</code> section, place it in a
<code>color_schemes</code> section as shown below; you can then reference it using the
<code>color_scheme</code> setting.</p>
<p>Color schemes names that you define in your <code>wezterm.lua</code> take precedence
over all other color schemes.</p>
<p>All of the settings available from the <code>colors</code> section are available
to use in the <code>color_schemes</code> sections.</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>color_scheme</a-v> = <a-s>&#39;Red Scheme&#39;</a-s>

<a-v>config</a-v><a-p>.</a-p><a-v>color_schemes</a-v> = <a-cr>{</a-cr>
  <a-p>[</a-p><a-s>&#39;Red Scheme&#39;</a-s><a-p>]</a-p> = <a-cr>{</a-cr>
    <a-v>background</a-v> = <a-s>&#39;red&#39;</a-s><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>
  <a-p>[</a-p><a-s>&#39;Blue Scheme&#39;</a-s><a-p>]</a-p> = <a-cr>{</a-cr>
    <a-v>background</a-v> = <a-s>&#39;blue&#39;</a-s><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>
<a-cr>}</a-cr></pre>
<p>See also <a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/wezterm/get_builtin_color_schemes.md">wezterm.get_builtin_color_schemes()</a> for
some more advanced examples, such as picking a random color scheme, or deriving from a
builting color scheme.</p>
<h3>Defining a Color Scheme in a separate file</h3>
<p>If you'd like to factor your color schemes out into separate files, you
can create a <a href="https://toml.io/en/">TOML format</a> file with a <code>[colors]</code> section; take a look at <a href="https://github.com/wezterm/wezterm/tree/main/config/src/scheme_data.rs">one of
the available color schemes for an example</a>.</p>
<p>It is recommended that you place your custom scheme in a directory
named <code>$HOME/.config/wezterm/colors</code> if you're on a POSIX system.</p>
<p>On a Windows system, <code>wezterm</code> will search for schemes in a directory
named <code>colors</code> that is in the same directory as the <code>wezterm.exe</code>.</p>
<p>If you wish to place your color scheme files in some other location, then you
will need to instruct wezterm where to look for your scheme files; the
<code>color_scheme_dirs</code> setting specifies a list of directories to be searched:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>color_scheme_dirs</a-v> = <a-cr>{</a-cr> <a-s>&#39;/some/path/to/my/color/schemes&#39;</a-s> <a-cr>}</a-cr></pre>
<p>Color scheme names that are defined in files in your <code>color_scheme_dirs</code> list
take precedence over the built-in color schemes.</p>
<h3>Dynamic Color Escape Sequences</h3>
<p>Wezterm supports dynamically changing its color palette via escape sequences.</p>
<p><a href="https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/dynamic-colors">The dynamic-colors directory</a>
of the color scheme repo contains shell scripts that can change the color
scheme immediately on the fly.  This can be used in your own scripts to alter
the terminal appearance programmatically:</p>
<pre class="language-bash"><a-o>$</a-o><a-f> </a-f><a-pr>git</a-pr> clone https://github.com/mbadolato/iTerm2-Color-Schemes.git
<a-o>$</a-o><a-f> </a-f><a-pr>cd</a-pr> iTerm2-Color-Schemes/dynamic-colors
<a-o>$</a-o><a-f> </a-f><a-pr>for</a-pr> scheme in *.sh ; <a-f>do</a-f> ; <a-f>echo</a-f> <a-o>$</a-o><a-pr>scheme</a-pr> ; \
   <a-f>bash</a-f> <a-s>&quot;</a-s><a-o>$</a-o><a-pr>scheme</a-pr><a-s>&quot;</a-s> ; <a-f>../tools/screenshotTable.sh</a-f>; <a-f>sleep</a-f> 0.5; <a-f>done</a-f></pre>
<p>&lt;video width="80%" controls src="../screenshots/wezterm-dynamic-colors.mp4" loop&gt;&lt;/video&gt;</p>
<h3>Tab Bar Appearance &amp; Colors</h3>
<p>The tab bar has two modes; the default is a native looking style, but
it is also possible to enable a retro aesthetic.  The configuration
for the two styles is broadly similar, but there are a few different
details.</p>
<ul>
<li><a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/config/use_fancy_tab_bar.md">use_fancy_tab_bar</a> option controls
which tab bar style is used.</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/config/enable_tab_bar.md">enable_tab_bar</a> option control
whether the tab bar is used at all.</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/config/hide_tab_bar_if_only_one_tab.md">hide_tab_bar_if_only_one_tab</a> option
causes the tab bar to be hidden when there is only a single tab.</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/config/tab_bar_at_bottom.md">tab_bar_at_bottom</a> places the tab
bar at the bottom of the window instead of the top</li>
<li><a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/config/tab_max_width.md">tab_max_width</a> sets the maximum width, measured in cells,
of a given tab when using retro tab mode.</li>
</ul>
<h4>Native (Fancy) Tab Bar appearance</h4>
<p>The following options affect the fancy tab bar:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>window_frame</a-v> = <a-cr>{</a-cr>
  <a-c>-- The font used in the tab bar.</a-c>
  <a-c>-- Roboto Bold is the default; this font is bundled</a-c>
  <a-c>-- with wezterm.</a-c>
  <a-c>-- Whatever font is selected here, it will have the</a-c>
  <a-c>-- main font setting appended to it to pick up any</a-c>
  <a-c>-- fallback fonts you may have used there.</a-c>
  <a-v>font</a-v> = <a-v>wezterm</a-v><a-p>.</a-p><a-f>font</a-f> <a-cr>{</a-cr> <a-v>family</a-v> = <a-s>&#39;Roboto&#39;</a-s><a-p>,</a-p> <a-v>weight</a-v> = <a-s>&#39;Bold&#39;</a-s> <a-cr>}</a-cr><a-p>,</a-p>

  <a-c>-- The size of the font in the tab bar.</a-c>
  <a-c>-- Default to 10.0 on Windows but 12.0 on other systems</a-c>
  <a-v>font_size</a-v> = <a-n>12.0</a-n><a-p>,</a-p>

  <a-c>-- The overall background color of the tab bar when</a-c>
  <a-c>-- the window is focused</a-c>
  <a-v>active_titlebar_bg</a-v> = <a-s>&#39;#333333&#39;</a-s><a-p>,</a-p>

  <a-c>-- The overall background color of the tab bar when</a-c>
  <a-c>-- the window is not focused</a-c>
  <a-v>inactive_titlebar_bg</a-v> = <a-s>&#39;#333333&#39;</a-s><a-p>,</a-p>
<a-cr>}</a-cr>

<a-v>config</a-v><a-p>.</a-p><a-v>colors</a-v> = <a-cr>{</a-cr>
  <a-v>tab_bar</a-v> = <a-cr>{</a-cr>
    <a-c>-- The color of the inactive tab bar edge/divider</a-c>
    <a-v>inactive_tab_edge</a-v> = <a-s>&#39;#575757&#39;</a-s><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>
<a-cr>}</a-cr></pre>
<p>In addition, the tab bar colors mentioned below also apply
to the items displayed in the tab bar.</p>
<h4>Retro Tab Bar appearance</h4>
<p>The following options control the appearance of the tab bar:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>colors</a-v> = <a-cr>{</a-cr>
  <a-v>tab_bar</a-v> = <a-cr>{</a-cr>
    <a-c>-- The color of the strip that goes along the top of the window</a-c>
    <a-c>-- (does not apply when fancy tab bar is in use)</a-c>
    <a-v>background</a-v> = <a-s>&#39;#0b0022&#39;</a-s><a-p>,</a-p>

    <a-c>-- The active tab is the one that has focus in the window</a-c>
    <a-v>active_tab</a-v> = <a-cr>{</a-cr>
      <a-c>-- The color of the background area for the tab</a-c>
      <a-v>bg_color</a-v> = <a-s>&#39;#2b2042&#39;</a-s><a-p>,</a-p>
      <a-c>-- The color of the text for the tab</a-c>
      <a-v>fg_color</a-v> = <a-s>&#39;#c0c0c0&#39;</a-s><a-p>,</a-p>

      <a-c>-- Specify whether you want &quot;Half&quot;, &quot;Normal&quot; or &quot;Bold&quot; intensity for the</a-c>
      <a-c>-- label shown for this tab.</a-c>
      <a-c>-- The default is &quot;Normal&quot;</a-c>
      <a-v>intensity</a-v> = <a-s>&#39;Normal&#39;</a-s><a-p>,</a-p>

      <a-c>-- Specify whether you want &quot;None&quot;, &quot;Single&quot; or &quot;Double&quot; underline for</a-c>
      <a-c>-- label shown for this tab.</a-c>
      <a-c>-- The default is &quot;None&quot;</a-c>
      <a-v>underline</a-v> = <a-s>&#39;None&#39;</a-s><a-p>,</a-p>

      <a-c>-- Specify whether you want the text to be italic (true) or not (false)</a-c>
      <a-c>-- for this tab.  The default is false.</a-c>
      <a-v>italic</a-v> = <a-co>false</a-co><a-p>,</a-p>

      <a-c>-- Specify whether you want the text to be rendered with strikethrough (true)</a-c>
      <a-c>-- or not for this tab.  The default is false.</a-c>
      <a-v>strikethrough</a-v> = <a-co>false</a-co><a-p>,</a-p>
    <a-cr>}</a-cr><a-p>,</a-p>

    <a-c>-- Inactive tabs are the tabs that do not have focus</a-c>
    <a-v>inactive_tab</a-v> = <a-cr>{</a-cr>
      <a-v>bg_color</a-v> = <a-s>&#39;#1b1032&#39;</a-s><a-p>,</a-p>
      <a-v>fg_color</a-v> = <a-s>&#39;#808080&#39;</a-s><a-p>,</a-p>

      <a-c>-- The same options that were listed under the `active_tab` section above</a-c>
      <a-c>-- can also be used for `inactive_tab`.</a-c>
    <a-cr>}</a-cr><a-p>,</a-p>

    <a-c>-- You can configure some alternate styling when the mouse pointer</a-c>
    <a-c>-- moves over inactive tabs</a-c>
    <a-v>inactive_tab_hover</a-v> = <a-cr>{</a-cr>
      <a-v>bg_color</a-v> = <a-s>&#39;#3b3052&#39;</a-s><a-p>,</a-p>
      <a-v>fg_color</a-v> = <a-s>&#39;#909090&#39;</a-s><a-p>,</a-p>
      <a-v>italic</a-v> = <a-co>true</a-co><a-p>,</a-p>

      <a-c>-- The same options that were listed under the `active_tab` section above</a-c>
      <a-c>-- can also be used for `inactive_tab_hover`.</a-c>
    <a-cr>}</a-cr><a-p>,</a-p>

    <a-c>-- The new tab button that let you create new tabs</a-c>
    <a-v>new_tab</a-v> = <a-cr>{</a-cr>
      <a-v>bg_color</a-v> = <a-s>&#39;#1b1032&#39;</a-s><a-p>,</a-p>
      <a-v>fg_color</a-v> = <a-s>&#39;#808080&#39;</a-s><a-p>,</a-p>

      <a-c>-- The same options that were listed under the `active_tab` section above</a-c>
      <a-c>-- can also be used for `new_tab`.</a-c>
    <a-cr>}</a-cr><a-p>,</a-p>

    <a-c>-- You can configure some alternate styling when the mouse pointer</a-c>
    <a-c>-- moves over the new tab button</a-c>
    <a-v>new_tab_hover</a-v> = <a-cr>{</a-cr>
      <a-v>bg_color</a-v> = <a-s>&#39;#3b3052&#39;</a-s><a-p>,</a-p>
      <a-v>fg_color</a-v> = <a-s>&#39;#909090&#39;</a-s><a-p>,</a-p>
      <a-v>italic</a-v> = <a-co>true</a-co><a-p>,</a-p>

      <a-c>-- The same options that were listed under the `active_tab` section above</a-c>
      <a-c>-- can also be used for `new_tab_hover`.</a-c>
    <a-cr>}</a-cr><a-p>,</a-p>
  <a-cr>}</a-cr><a-p>,</a-p>
<a-cr>}</a-cr></pre>
<h3>Window Padding</h3>
<p>You may add padding around the edges of the terminal area.</p>
<p><a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/config/window_padding.md">See the window_padding docs for more info</a></p>
<h2>Styling Inactive Panes</h2>
<p>{{since('20201031-154415-9614e117')}}</p>
<p>To make it easier to see which pane is active, the inactive panes are dimmed
and de-saturated slightly.</p>
<p>You can specify your own transformation to the pane colors with a hue,
saturation, brightness (HSB) multiplier.</p>
<p>In this example, inactive panes will be slightly de-saturated and dimmed;
this is the default configuration:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>inactive_pane_hsb</a-v> = <a-cr>{</a-cr>
  <a-v>saturation</a-v> = <a-n>0.9</a-n><a-p>,</a-p>
  <a-v>brightness</a-v> = <a-n>0.8</a-n><a-p>,</a-p>
<a-cr>}</a-cr></pre>
<p>The transform works by converting the RGB colors to HSV values and
then multiplying the HSV by the numbers specified in <code>inactive_pane_hsb</code>.</p>
<p>Modifying the hue changes the hue of the color by rotating it through the color
wheel. It is not as useful as the other components, but is available "for free"
as part of the colorspace conversion.</p>
<p>Modifying the saturation can add or reduce the amount of "colorfulness". Making
the value smaller can make it appear more washed out.</p>
<p>Modifying the brightness can be used to dim or increase the perceived amount of
light.</p>
<p>The range of these values is 0.0 and up; they are used to multiply the existing
values, so the default of 1.0 preserves the existing component, whilst 0.5 will
reduce it by half, and 2.0 will double the value.</p>
<h2>Window Background Image</h2>
<p><img src="/fork/wezterm/raw/f47ef73e94b9c0a772fc40e9d9497aa2e3673378/docs/screenshots/wezterm-vday-screenshot.png" alt="Screenshot" /></p>
<p>{{since('20201031-154415-9614e117')}}</p>
<p>You can attach an image to the background of the wezterm window:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>window_background_image</a-v> = <a-s>&#39;/path/to/wallpaper.jpg&#39;</a-s></pre>
<p>If the path is a relative path then it will be expanded relative
to the directory containing your <code>wezterm.lua</code> config file.</p>
<p>PNG, JPEG, GIF, BMP, ICO, TIFF, PNM, DDS, TGA and farbfeld files
can be loaded.  Animated GIF and PNG files will animate while
the window has focus.</p>
<p>The image will be scaled to fit the window contents.  Very large
images may decrease render performance and take up VRAM from the
GPU, so you may wish to resize the image file before using it.</p>
<p>You can optionally transform the background image by specifying
a hue, saturation, brightness multiplier:</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>window_background_image</a-v> = <a-s>&#39;/path/to/wallpaper.jpg&#39;</a-s>

<a-v>config</a-v><a-p>.</a-p><a-v>window_background_image_hsb</a-v> = <a-cr>{</a-cr>
  <a-c>-- Darken the background image by reducing it to 1/3rd</a-c>
  <a-v>brightness</a-v> = <a-n>0.3</a-n><a-p>,</a-p>

  <a-c>-- You can adjust the hue by scaling its value.</a-c>
  <a-c>-- a multiplier of 1.0 leaves the value unchanged.</a-c>
  <a-v>hue</a-v> = <a-n>1.0</a-n><a-p>,</a-p>

  <a-c>-- You can adjust the saturation also.</a-c>
  <a-v>saturation</a-v> = <a-n>1.0</a-n><a-p>,</a-p>
<a-cr>}</a-cr></pre>
<p>See <a href="#styling-inactive-panes">Styling Inactive Panes</a> for more information
on hue, saturation, brightness transformations.</p>
<p>If you'd like to have control over scaling, tiling/repeating, scrolling
behavior and more, take a look at the more powerful
<a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/config/background.md">background</a> configuration option.</p>
<h2>Window Background Gradient</h2>
<p>{{since('20210814-124438-54e29167')}}</p>
<p><img src="/fork/wezterm/raw/24d236ec83e40dec354813cc405294d663e86e34/docs/screenshots/radial-gradient.png" alt="Gradient" /></p>
<p>See <a href="/fork/wezterm/ref/termiz-0.23.3/blob/docs/config/lua/config/window_background_gradient.md">window_background_gradient</a>
for configuration information on gradients.</p>
<h2>Window Background Opacity</h2>
<p>{{since('20201031-154415-9614e117')}}</p>
<p>If your Operating System provides Compositing support then WezTerm is able to
specify the alpha channel value for the background content, rendering the
window background translucent (some refer to this as transparent rather than
translucent) and causing the windows/desktop behind it to show through the
window.</p>
<p>macOS, Windows and Wayland support compositing out of the box. X11 may require
installing or configuring a compositing window manager. XWayland under
Mutter/Wayland also works without any additional configuration.</p>
<p><code>window_background_opacity</code> specifies the alpha channel value
with floating point numbers in the range <code>0.0</code> (meaning completely
translucent/transparent) through to <code>1.0</code> (meaning completely opaque).</p>
<p>Setting this to a value other than the default <code>1.0</code> may impact render
performance.</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>window_background_opacity</a-v> = <a-n>1.0</a-n></pre>
<h2>Text Background Opacity</h2>
<p>{{since('20201031-154415-9614e117')}}</p>
<p>When using a background image or background opacity, the image content can
have relatively low contrast with respect to the text you are trying to
read in your terminal.</p>
<p>The <code>text_background_opacity</code> setting specifies the alpha channel value to use
for the background color of cells other than the default background color.</p>
<p>The default for this setting is <code>1.0</code>, which means that the background
color is fully opaque.</p>
<p>The range of values permitted are <code>0.0</code> (completely translucent)
through to <code>1.0</code> (completely opaque).</p>
<pre class="language-lua"><a-v>config</a-v><a-p>.</a-p><a-v>text_background_opacity</a-v> = <a-n>0.3</a-n></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>Color Scheme</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 ships with over 700 color schemes available from</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text">[iTerm2-Color-Schemes](https://github.com/mbadolato/iTerm2-Color-Schemes#screenshots),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">[base16](https://github.com/chriskempson/base16-schemes-source),</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text">[Gogh](https://gogh-co.github.io/Gogh/) and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text">[terminal.sexy](https://terminal.sexy/) and a couple of other locations.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text">You can select a color scheme with a line like this:</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>local </a-p><a-v>wezterm</a-v><a-p> = </a-p><a-f>require</a-f><a-p> </a-p><a-s>&#39;wezterm&#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>local </a-p><a-v>config</a-v><a-p> = </a-p><a-cr>{}</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"></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>color_scheme</a-v><a-p> = </a-p><a-s>&#39;Batman&#39;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"></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>return </a-p><a-v>config</a-v></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"><a-p>You can find a list of available color schemes and screenshots</a-p></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>in [The Color Schemes Section](../colorschemes/index.md).</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"></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>If you&#39;d like to automatically adjust your color scheme based on the</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>system dark mode or light mode appearance, see the example in</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"><a-p>[wezterm.gui.get_appearance()](lua/wezterm.gui/get_appearance.md)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"></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>!!! note</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>    if you are using multiplexing with ssh or tls domains, the color scheme</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"><a-p>    is controlled by the config file on the multiplexer server side. This is</a-p></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>    because the palette is an attribute of the terminal emulation and that state</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>    lives on the multiplexer server.*</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"><a-p>### </a-p><a-tt>Precedence of `colors` vs `color_schemes`</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"></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>The `color_scheme` option takes precedence over the `colors` section below,</a-p></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>and is mutually exclusive with it. If you want to merge/override colors</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>you need to use [wezterm.color.get_default_colors()](lua/wezterm.color/get_default_colors.md) and explicitly merge them.</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"></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>{{since(&#39;20220903-194523-3bb1ed61&#39;)}}</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>The behavior has been changed so that the `color_scheme` you have selected, if</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>any, is used to define the colors, and then any colors you define in the</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"><a-p>`colors` section will override those colors.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"></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>### </a-p><a-tt>Defining your own colors</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"></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>You can specify the color palette using the `colors` configuration section.</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"></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>You can configure colors with a section like this.  In addition to specifying</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"><a-p>[SVG/CSS3 color names](https://docs.rs/palette/0.4.1/palette/named/index.html#constants),</a-p></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>you can use `#RRGGBB` to specify a color code using the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>usual hex notation; eg: `#000000` is equivalent to `black`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</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="L55" href="#L55">55</a><span class="code-text"><a-p>local </a-p><a-v>wezterm</a-v><a-p> = </a-p><a-f>require</a-f><a-p> </a-p><a-s>&#39;wezterm&#39;</a-s></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>local </a-p><a-v>config</a-v><a-p> = </a-p><a-cr>{}</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"></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>config.</a-p><a-v>colors</a-v><a-p> = </a-p><a-cr>{</a-cr></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>  </a-p><a-c>-- The default text color</a-c></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>  </a-p><a-v>foreground</a-v><a-p> = </a-p><a-s>&#39;silver&#39;</a-s><a-p>,</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>  </a-p><a-c>-- The default background color</a-c></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>  </a-p><a-v>background</a-v><a-p> = </a-p><a-s>&#39;black&#39;</a-s><a-p>,</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"></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>  </a-p><a-c>-- Overrides the cell background color when the current cell is occupied by the</a-c></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>  </a-p><a-c>-- cursor and the cursor style is set to Block</a-c></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>  </a-p><a-v>cursor_bg</a-v><a-p> = </a-p><a-s>&#39;#52ad70&#39;</a-s><a-p>,</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>  </a-p><a-c>-- Overrides the text color when the current cell is occupied by the cursor</a-c></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>  </a-p><a-v>cursor_fg</a-v><a-p> = </a-p><a-s>&#39;black&#39;</a-s><a-p>,</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"><a-p>  </a-p><a-c>-- Specifies the border color of the cursor when the cursor style is set to Block,</a-c></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-c>-- or the color of the vertical or horizontal bar when the cursor style is set to</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"><a-p>  </a-p><a-c>-- Bar or Underline.</a-c></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>  </a-p><a-v>cursor_border</a-v><a-p> = </a-p><a-s>&#39;#52ad70&#39;</a-s><a-p>,</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>  </a-p><a-c>-- the foreground color of selected text</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"><a-p>  </a-p><a-v>selection_fg</a-v><a-p> = </a-p><a-s>&#39;black&#39;</a-s><a-p>,</a-p></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-c>-- the background color of selected text</a-c></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>  </a-p><a-v>selection_bg</a-v><a-p> = </a-p><a-s>&#39;#fffacd&#39;</a-s><a-p>,</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"></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>  </a-p><a-c>-- The color of the scrollbar &quot;thumb&quot;; the portion that represents the current viewport</a-c></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>  </a-p><a-v>scrollbar_thumb</a-v><a-p> = </a-p><a-s>&#39;#222222&#39;</a-s><a-p>,</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"><a-p>  </a-p><a-c>-- The color of the split lines between panes</a-c></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>  </a-p><a-v>split</a-v><a-p> = </a-p><a-s>&#39;#444444&#39;</a-s><a-p>,</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"><a-p>  </a-p><a-v>ansi</a-v><a-p> = </a-p><a-cr>{</a-cr></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>    </a-p><a-s>&#39;black&#39;</a-s><a-p>,</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>    </a-p><a-s>&#39;maroon&#39;</a-s><a-p>,</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"><a-p>    </a-p><a-s>&#39;green&#39;</a-s><a-p>,</a-p></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>    </a-p><a-s>&#39;olive&#39;</a-s><a-p>,</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>    </a-p><a-s>&#39;navy&#39;</a-s><a-p>,</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>    </a-p><a-s>&#39;purple&#39;</a-s><a-p>,</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>    </a-p><a-s>&#39;teal&#39;</a-s><a-p>,</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><a-s>&#39;silver&#39;</a-s><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"><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="L95" href="#L95">95</a><span class="code-text"><a-p>  </a-p><a-v>brights</a-v><a-p> = </a-p><a-cr>{</a-cr></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>    </a-p><a-s>&#39;grey&#39;</a-s><a-p>,</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>    </a-p><a-s>&#39;red&#39;</a-s><a-p>,</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>    </a-p><a-s>&#39;lime&#39;</a-s><a-p>,</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>    </a-p><a-s>&#39;yellow&#39;</a-s><a-p>,</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"><a-p>    </a-p><a-s>&#39;blue&#39;</a-s><a-p>,</a-p></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>    </a-p><a-s>&#39;fuchsia&#39;</a-s><a-p>,</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>    </a-p><a-s>&#39;aqua&#39;</a-s><a-p>,</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"><a-p>    </a-p><a-s>&#39;white&#39;</a-s><a-p>,</a-p></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>  </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="L105" href="#L105">105</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"><a-p>  </a-p><a-c>-- Arbitrary colors of the palette in the range from 16 to 255</a-c></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>  </a-p><a-v>indexed</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> [</a-p><a-n>136</a-n><a-p>] = </a-p><a-s>&#39;#af8700&#39;</a-s><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="L108" href="#L108">108</a><span class="code-text"></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>  </a-p><a-c>-- Since: 20220319-142410-0fcdea07</a-c></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>  </a-p><a-c>-- When the IME, a dead key or a leader key are being processed and are effectively</a-c></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><a-c>-- holding input pending the result of input composition, change the cursor</a-c></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><a-c>-- to this color to give a visual cue about the compose state.</a-c></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><a-v>compose_cursor</a-v><a-p> = </a-p><a-s>&#39;orange&#39;</a-s><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>  </a-p><a-c>-- Colors for copy_mode and quick_select</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text"><a-p>  </a-p><a-c>-- available since: 20220807-113146-c2fee766</a-c></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-c>-- In copy_mode, the color of the active text is:</a-c></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>  </a-p><a-c>-- 1. copy_mode_active_highlight_* if additional text was selected using the mouse</a-c></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>  </a-p><a-c>-- 2. selection_* otherwise</a-c></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>  </a-p><a-v>copy_mode_active_highlight_bg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>Color</a-v><a-p> = </a-p><a-s>&#39;#000000&#39;</a-s><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="L121" href="#L121">121</a><span class="code-text"><a-p>  </a-p><a-c>-- use `AnsiColor` to specify one of the ansi color palette values</a-c></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>  </a-p><a-c>-- (index 0-15) using one of the names &quot;Black&quot;, &quot;Maroon&quot;, &quot;Green&quot;,</a-c></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>  </a-p><a-c>--  &quot;Olive&quot;, &quot;Navy&quot;, &quot;Purple&quot;, &quot;Teal&quot;, &quot;Silver&quot;, &quot;Grey&quot;, &quot;Red&quot;, &quot;Lime&quot;,</a-c></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>  </a-p><a-c>-- &quot;Yellow&quot;, &quot;Blue&quot;, &quot;Fuchsia&quot;, &quot;Aqua&quot; or &quot;White&quot;.</a-c></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>  </a-p><a-v>copy_mode_active_highlight_fg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>AnsiColor</a-v><a-p> = </a-p><a-s>&#39;Black&#39;</a-s><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="L126" href="#L126">126</a><span class="code-text"><a-p>  </a-p><a-v>copy_mode_inactive_highlight_bg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>Color</a-v><a-p> = </a-p><a-s>&#39;#52ad70&#39;</a-s><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="L127" href="#L127">127</a><span class="code-text"><a-p>  </a-p><a-v>copy_mode_inactive_highlight_fg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>AnsiColor</a-v><a-p> = </a-p><a-s>&#39;White&#39;</a-s><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="L128" href="#L128">128</a><span class="code-text"></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>  </a-p><a-v>quick_select_label_bg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>Color</a-v><a-p> = </a-p><a-s>&#39;peru&#39;</a-s><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="L130" href="#L130">130</a><span class="code-text"><a-p>  </a-p><a-v>quick_select_label_fg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>Color</a-v><a-p> = </a-p><a-s>&#39;#ffffff&#39;</a-s><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="L131" href="#L131">131</a><span class="code-text"><a-p>  </a-p><a-v>quick_select_match_bg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>AnsiColor</a-v><a-p> = </a-p><a-s>&#39;Navy&#39;</a-s><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="L132" href="#L132">132</a><span class="code-text"><a-p>  </a-p><a-v>quick_select_match_fg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>Color</a-v><a-p> = </a-p><a-s>&#39;#ffffff&#39;</a-s><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="L133" href="#L133">133</a><span class="code-text"></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>  </a-p><a-v>input_selector_label_bg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>AnsiColor</a-v><a-p> = </a-p><a-s>&#39;Black&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>, </a-p><a-c>-- {{since(&#39;nightly&#39;, inline=True)}}</a-c></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>  </a-p><a-v>input_selector_label_fg</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-v>Color</a-v><a-p> = </a-p><a-s>&#39;#ffffff&#39;</a-s><a-p> </a-p><a-cr>}</a-cr><a-p>, </a-p><a-c>-- {{since(&#39;nightly&#39;, inline=True)}}</a-c></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>}</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"></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>return </a-p><a-v>config</a-v></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>```</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"></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>{{since(&#39;20220101-133340-7edc5b5a&#39;)}}</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text"><a-p>You may specify colors in the HSL color space, if you prefer that over RGB, by using:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L144" href="#L144">144</a><span class="code-text"></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>```</a-p><a-tl>lua</a-tl></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>config.</a-p><a-v>colors</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text"><a-p>  </a-p><a-c>-- the first number is the hue measured in degrees with a range</a-c></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-c>-- of 0-360.</a-c></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>  </a-p><a-c>-- The second number is the saturation measured in percentage with</a-c></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-p><a-c>-- a range of 0-100.</a-c></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>  </a-p><a-c>-- The third number is the lightness measured in percentage with</a-c></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>  </a-p><a-c>-- a range of 0-100.</a-c></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>  </a-p><a-v>foreground</a-v><a-p> = </a-p><a-s>&#39;hsl:235 100 50&#39;</a-s><a-p>,</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>}</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>```</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L157" href="#L157">157</a><span class="code-text"><a-p>{{since(&#39;20220319-142410-0fcdea07&#39;)}}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L158" href="#L158">158</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L159" href="#L159">159</a><span class="code-text"><a-p>Colors now also accept the following CSS-style color specifications:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L160" href="#L160">160</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L161" href="#L161">161</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L162" href="#L162">162</a><span class="code-text"><a-p>rgb(0,255,0)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L163" href="#L163">163</a><span class="code-text"><a-p>rgb(0% 100% 0%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L164" href="#L164">164</a><span class="code-text"><a-p>rgb(0 255 0 / 100%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L165" href="#L165">165</a><span class="code-text"><a-p>rgba(0,255,0,1)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L166" href="#L166">166</a><span class="code-text"><a-p>hsl(120,100%,50%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L167" href="#L167">167</a><span class="code-text"><a-p>hsl(120deg 100% 50%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L168" href="#L168">168</a><span class="code-text"><a-p>hsl(-240 100% 50%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L169" href="#L169">169</a><span class="code-text"><a-p>hsl(-240deg 100% 50%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L170" href="#L170">170</a><span class="code-text"><a-p>hsl(0.3333turn 100% 50%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L171" href="#L171">171</a><span class="code-text"><a-p>hsl(133.333grad 100% 50%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L172" href="#L172">172</a><span class="code-text"><a-p>hsl(2.0944rad 100% 50%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L173" href="#L173">173</a><span class="code-text"><a-p>hsla(120,100%,50%,100%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L174" href="#L174">174</a><span class="code-text"><a-p>hwb(120 0% 0%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L175" href="#L175">175</a><span class="code-text"><a-p>hwb(480deg 0% 0% / 100%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L176" href="#L176">176</a><span class="code-text"><a-p>hsv(120,100%,100%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L177" href="#L177">177</a><span class="code-text"><a-p>hsv(120deg 100% 100% / 100%)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L178" href="#L178">178</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L179" href="#L179">179</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L180" href="#L180">180</a><span class="code-text"><a-p>The alpha value is ignored except when used with `selection_fg` and</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L181" href="#L181">181</a><span class="code-text"><a-p>`selection_bg`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L182" href="#L182">182</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L183" href="#L183">183</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="L184" href="#L184">184</a><span class="code-text"><a-p>config.</a-p><a-v>colors</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L185" href="#L185">185</a><span class="code-text"><a-p>  </a-p><a-c>-- Make the selection text color fully transparent.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L186" href="#L186">186</a><span class="code-text"><a-p>  </a-p><a-c>-- When fully transparent, the current text color will be used.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L187" href="#L187">187</a><span class="code-text"><a-p>  </a-p><a-v>selection_fg</a-v><a-p> = </a-p><a-s>&#39;none&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L188" href="#L188">188</a><span class="code-text"><a-p>  </a-p><a-c>-- Set the selection background color with alpha.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L189" href="#L189">189</a><span class="code-text"><a-p>  </a-p><a-c>-- When selection_bg is transparent, it will be alpha blended over</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L190" href="#L190">190</a><span class="code-text"><a-p>  </a-p><a-c>-- the current cell background color, rather than replace it</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L191" href="#L191">191</a><span class="code-text"><a-p>  </a-p><a-v>selection_bg</a-v><a-p> = </a-p><a-s>&#39;rgba(50% 50% 50% 50%)&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L192" href="#L192">192</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L193" href="#L193">193</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L194" href="#L194">194</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L195" href="#L195">195</a><span class="code-text"><a-p>### </a-p><a-tt>Defining a Color Scheme in your `.wezterm.lua`</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L196" href="#L196">196</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L197" href="#L197">197</a><span class="code-text"><a-p>If you&#39;d like to keep a couple of color schemes handy in your configuration</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L198" href="#L198">198</a><span class="code-text"><a-p>file, rather than filling out the `colors` section, place it in a</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L199" href="#L199">199</a><span class="code-text"><a-p>`color_schemes` section as shown below; you can then reference it using the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L200" href="#L200">200</a><span class="code-text"><a-p>`color_scheme` setting.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L201" href="#L201">201</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L202" href="#L202">202</a><span class="code-text"><a-p>Color schemes names that you define in your `wezterm.lua` take precedence</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L203" href="#L203">203</a><span class="code-text"><a-p>over all other color schemes.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L204" href="#L204">204</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L205" href="#L205">205</a><span class="code-text"><a-p>All of the settings available from the `colors` section are available</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L206" href="#L206">206</a><span class="code-text"><a-p>to use in the `color_schemes` sections.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L207" href="#L207">207</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L208" href="#L208">208</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="L209" href="#L209">209</a><span class="code-text"><a-p>config.</a-p><a-v>color_scheme</a-v><a-p> = </a-p><a-s>&#39;Red Scheme&#39;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L210" href="#L210">210</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L211" href="#L211">211</a><span class="code-text"><a-p>config.</a-p><a-v>color_schemes</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L212" href="#L212">212</a><span class="code-text"><a-p>  [</a-p><a-s>&#39;Red Scheme&#39;</a-s><a-p>] = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L213" href="#L213">213</a><span class="code-text"><a-p>    </a-p><a-v>background</a-v><a-p> = </a-p><a-s>&#39;red&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L214" href="#L214">214</a><span class="code-text"><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="L215" href="#L215">215</a><span class="code-text"><a-p>  [</a-p><a-s>&#39;Blue Scheme&#39;</a-s><a-p>] = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L216" href="#L216">216</a><span class="code-text"><a-p>    </a-p><a-v>background</a-v><a-p> = </a-p><a-s>&#39;blue&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L217" href="#L217">217</a><span class="code-text"><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="L218" href="#L218">218</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L219" href="#L219">219</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L220" href="#L220">220</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L221" href="#L221">221</a><span class="code-text"><a-p>See also [wezterm.get_builtin_color_schemes()](lua/wezterm/get_builtin_color_schemes.md) for</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L222" href="#L222">222</a><span class="code-text"><a-p>some more advanced examples, such as picking a random color scheme, or deriving from a</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L223" href="#L223">223</a><span class="code-text"><a-p>builting color scheme.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L224" href="#L224">224</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L225" href="#L225">225</a><span class="code-text"><a-p>### </a-p><a-tt>Defining a Color Scheme in a separate file</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L226" href="#L226">226</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L227" href="#L227">227</a><span class="code-text"><a-p>If you&#39;d like to factor your color schemes out into separate files, you</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L228" href="#L228">228</a><span class="code-text"><a-p>can create a [TOML format](https://toml.io/en/) file with a `[colors]` section; take a look at [one of</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L229" href="#L229">229</a><span class="code-text"><a-p>the available color schemes for an example](https://github.com/wezterm/wezterm/tree/main/config/src/scheme_data.rs).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L230" href="#L230">230</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L231" href="#L231">231</a><span class="code-text"><a-p>It is recommended that you place your custom scheme in a directory</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L232" href="#L232">232</a><span class="code-text"><a-p>named `$HOME/.config/wezterm/colors` if you&#39;re on a POSIX system.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L233" href="#L233">233</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L234" href="#L234">234</a><span class="code-text"><a-p>On a Windows system, `wezterm` will search for schemes in a directory</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L235" href="#L235">235</a><span class="code-text"><a-p>named `colors` that is in the same directory as the `wezterm.exe`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L236" href="#L236">236</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L237" href="#L237">237</a><span class="code-text"><a-p>If you wish to place your color scheme files in some other location, then you</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L238" href="#L238">238</a><span class="code-text"><a-p>will need to instruct wezterm where to look for your scheme files; the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L239" href="#L239">239</a><span class="code-text"><a-p>`color_scheme_dirs` setting specifies a list of directories to be searched:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L240" href="#L240">240</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L241" href="#L241">241</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="L242" href="#L242">242</a><span class="code-text"><a-p>config.</a-p><a-v>color_scheme_dirs</a-v><a-p> = </a-p><a-cr>{</a-cr><a-p> </a-p><a-s>&#39;/some/path/to/my/color/schemes&#39;</a-s><a-p> </a-p><a-cr>}</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L243" href="#L243">243</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L244" href="#L244">244</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L245" href="#L245">245</a><span class="code-text"><a-p>Color scheme names that are defined in files in your `color_scheme_dirs` list</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L246" href="#L246">246</a><span class="code-text"><a-p>take precedence over the built-in color schemes.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L247" href="#L247">247</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L248" href="#L248">248</a><span class="code-text"><a-p>### </a-p><a-tt>Dynamic Color Escape Sequences</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L249" href="#L249">249</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L250" href="#L250">250</a><span class="code-text"><a-p>Wezterm supports dynamically changing its color palette via escape sequences.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L251" href="#L251">251</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L252" href="#L252">252</a><span class="code-text"><a-p>[The dynamic-colors directory](https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/dynamic-colors)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L253" href="#L253">253</a><span class="code-text"><a-p>of the color scheme repo contains shell scripts that can change the color</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L254" href="#L254">254</a><span class="code-text"><a-p>scheme immediately on the fly.  This can be used in your own scripts to alter</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L255" href="#L255">255</a><span class="code-text"><a-p>the terminal appearance programmatically:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L256" href="#L256">256</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L257" href="#L257">257</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="L258" href="#L258">258</a><span class="code-text"><a-p>$ git clone https://github.com/mbadolato/iTerm2-Color-Schemes.git</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L259" href="#L259">259</a><span class="code-text"><a-p>$ cd iTerm2-Color-Schemes/dynamic-colors</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L260" href="#L260">260</a><span class="code-text"><a-p>$ for scheme in *.sh ; do ; echo $scheme ; \</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L261" href="#L261">261</a><span class="code-text"><a-p>   bash &quot;$scheme&quot; ; ../tools/screenshotTable.sh; sleep 0.5; done</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L262" href="#L262">262</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L263" href="#L263">263</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L264" href="#L264">264</a><span class="code-text"><a-p>  &lt;video width=&quot;80%&quot; controls src=&quot;../screenshots/wezterm-dynamic-colors.mp4&quot; loop&gt;&lt;/video&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L265" href="#L265">265</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L266" href="#L266">266</a><span class="code-text"><a-p>### </a-p><a-tt>Tab Bar Appearance &amp; Colors</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L267" href="#L267">267</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L268" href="#L268">268</a><span class="code-text"><a-p>The tab bar has two modes; the default is a native looking style, but</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L269" href="#L269">269</a><span class="code-text"><a-p>it is also possible to enable a retro aesthetic.  The configuration</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L270" href="#L270">270</a><span class="code-text"><a-p>for the two styles is broadly similar, but there are a few different</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L271" href="#L271">271</a><span class="code-text"><a-p>details.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L272" href="#L272">272</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L273" href="#L273">273</a><span class="code-text"><a-p>* [use_fancy_tab_bar](lua/config/use_fancy_tab_bar.md) option controls</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L274" href="#L274">274</a><span class="code-text"><a-p>  which tab bar style is used.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L275" href="#L275">275</a><span class="code-text"><a-p>* [enable_tab_bar](lua/config/enable_tab_bar.md) option control</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L276" href="#L276">276</a><span class="code-text"><a-p>  whether the tab bar is used at all.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L277" href="#L277">277</a><span class="code-text"><a-p>* [hide_tab_bar_if_only_one_tab](lua/config/hide_tab_bar_if_only_one_tab.md) option</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L278" href="#L278">278</a><span class="code-text"><a-p>  causes the tab bar to be hidden when there is only a single tab.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L279" href="#L279">279</a><span class="code-text"><a-p>* [tab_bar_at_bottom](lua/config/tab_bar_at_bottom.md) places the tab</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L280" href="#L280">280</a><span class="code-text"><a-p>  bar at the bottom of the window instead of the top</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L281" href="#L281">281</a><span class="code-text"><a-p>* [tab_max_width](lua/config/tab_max_width.md) sets the maximum width, measured in cells,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L282" href="#L282">282</a><span class="code-text"><a-p>  of a given tab when using retro tab mode.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L283" href="#L283">283</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L284" href="#L284">284</a><span class="code-text"><a-p>#### </a-p><a-tt>Native (Fancy) Tab Bar appearance</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L285" href="#L285">285</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L286" href="#L286">286</a><span class="code-text"><a-p>The following options affect the fancy tab bar:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L287" href="#L287">287</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L288" href="#L288">288</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="L289" href="#L289">289</a><span class="code-text"><a-p>config.</a-p><a-v>window_frame</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L290" href="#L290">290</a><span class="code-text"><a-p>  </a-p><a-c>-- The font used in the tab bar.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L291" href="#L291">291</a><span class="code-text"><a-p>  </a-p><a-c>-- Roboto Bold is the default; this font is bundled</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L292" href="#L292">292</a><span class="code-text"><a-p>  </a-p><a-c>-- with wezterm.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L293" href="#L293">293</a><span class="code-text"><a-p>  </a-p><a-c>-- Whatever font is selected here, it will have the</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L294" href="#L294">294</a><span class="code-text"><a-p>  </a-p><a-c>-- main font setting appended to it to pick up any</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L295" href="#L295">295</a><span class="code-text"><a-p>  </a-p><a-c>-- fallback fonts you may have used there.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L296" href="#L296">296</a><span class="code-text"><a-p>  </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-cr>{</a-cr><a-p> </a-p><a-v>family</a-v><a-p> = </a-p><a-s>&#39;Roboto&#39;</a-s><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-cr>}</a-cr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L297" href="#L297">297</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L298" href="#L298">298</a><span class="code-text"><a-p>  </a-p><a-c>-- The size of the font in the tab bar.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L299" href="#L299">299</a><span class="code-text"><a-p>  </a-p><a-c>-- Default to 10.0 on Windows but 12.0 on other systems</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L300" href="#L300">300</a><span class="code-text"><a-p>  </a-p><a-v>font_size</a-v><a-p> = </a-p><a-n>12.0</a-n><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L301" href="#L301">301</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L302" href="#L302">302</a><span class="code-text"><a-p>  </a-p><a-c>-- The overall background color of the tab bar when</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L303" href="#L303">303</a><span class="code-text"><a-p>  </a-p><a-c>-- the window is focused</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L304" href="#L304">304</a><span class="code-text"><a-p>  </a-p><a-v>active_titlebar_bg</a-v><a-p> = </a-p><a-s>&#39;#333333&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L305" href="#L305">305</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L306" href="#L306">306</a><span class="code-text"><a-p>  </a-p><a-c>-- The overall background color of the tab bar when</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L307" href="#L307">307</a><span class="code-text"><a-p>  </a-p><a-c>-- the window is not focused</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L308" href="#L308">308</a><span class="code-text"><a-p>  </a-p><a-v>inactive_titlebar_bg</a-v><a-p> = </a-p><a-s>&#39;#333333&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L309" href="#L309">309</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L310" href="#L310">310</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L311" href="#L311">311</a><span class="code-text"><a-p>config.</a-p><a-v>colors</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L312" href="#L312">312</a><span class="code-text"><a-p>  </a-p><a-v>tab_bar</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L313" href="#L313">313</a><span class="code-text"><a-p>    </a-p><a-c>-- The color of the inactive tab bar edge/divider</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L314" href="#L314">314</a><span class="code-text"><a-p>    </a-p><a-v>inactive_tab_edge</a-v><a-p> = </a-p><a-s>&#39;#575757&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L315" href="#L315">315</a><span class="code-text"><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="L316" href="#L316">316</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L317" href="#L317">317</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L318" href="#L318">318</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L319" href="#L319">319</a><span class="code-text"><a-p>In addition, the tab bar colors mentioned below also apply</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L320" href="#L320">320</a><span class="code-text"><a-p>to the items displayed in the tab bar.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L321" href="#L321">321</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L322" href="#L322">322</a><span class="code-text"><a-p>#### </a-p><a-tt>Retro Tab Bar appearance</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L323" href="#L323">323</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L324" href="#L324">324</a><span class="code-text"><a-p>The following options control the appearance of the tab bar:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L325" href="#L325">325</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L326" href="#L326">326</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="L327" href="#L327">327</a><span class="code-text"><a-p>config.</a-p><a-v>colors</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L328" href="#L328">328</a><span class="code-text"><a-p>  </a-p><a-v>tab_bar</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L329" href="#L329">329</a><span class="code-text"><a-p>    </a-p><a-c>-- The color of the strip that goes along the top of the window</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L330" href="#L330">330</a><span class="code-text"><a-p>    </a-p><a-c>-- (does not apply when fancy tab bar is in use)</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L331" href="#L331">331</a><span class="code-text"><a-p>    </a-p><a-v>background</a-v><a-p> = </a-p><a-s>&#39;#0b0022&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L332" href="#L332">332</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L333" href="#L333">333</a><span class="code-text"><a-p>    </a-p><a-c>-- The active tab is the one that has focus in the window</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L334" href="#L334">334</a><span class="code-text"><a-p>    </a-p><a-v>active_tab</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L335" href="#L335">335</a><span class="code-text"><a-p>      </a-p><a-c>-- The color of the background area for the tab</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L336" href="#L336">336</a><span class="code-text"><a-p>      </a-p><a-v>bg_color</a-v><a-p> = </a-p><a-s>&#39;#2b2042&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L337" href="#L337">337</a><span class="code-text"><a-p>      </a-p><a-c>-- The color of the text for the tab</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L338" href="#L338">338</a><span class="code-text"><a-p>      </a-p><a-v>fg_color</a-v><a-p> = </a-p><a-s>&#39;#c0c0c0&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L339" href="#L339">339</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L340" href="#L340">340</a><span class="code-text"><a-p>      </a-p><a-c>-- Specify whether you want &quot;Half&quot;, &quot;Normal&quot; or &quot;Bold&quot; intensity for the</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L341" href="#L341">341</a><span class="code-text"><a-p>      </a-p><a-c>-- label shown for this tab.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L342" href="#L342">342</a><span class="code-text"><a-p>      </a-p><a-c>-- The default is &quot;Normal&quot;</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L343" href="#L343">343</a><span class="code-text"><a-p>      </a-p><a-v>intensity</a-v><a-p> = </a-p><a-s>&#39;Normal&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L344" href="#L344">344</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L345" href="#L345">345</a><span class="code-text"><a-p>      </a-p><a-c>-- Specify whether you want &quot;None&quot;, &quot;Single&quot; or &quot;Double&quot; underline for</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L346" href="#L346">346</a><span class="code-text"><a-p>      </a-p><a-c>-- label shown for this tab.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L347" href="#L347">347</a><span class="code-text"><a-p>      </a-p><a-c>-- The default is &quot;None&quot;</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L348" href="#L348">348</a><span class="code-text"><a-p>      </a-p><a-v>underline</a-v><a-p> = </a-p><a-s>&#39;None&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L349" href="#L349">349</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L350" href="#L350">350</a><span class="code-text"><a-p>      </a-p><a-c>-- Specify whether you want the text to be italic (true) or not (false)</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L351" href="#L351">351</a><span class="code-text"><a-p>      </a-p><a-c>-- for this tab.  The default is false.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L352" href="#L352">352</a><span class="code-text"><a-p>      </a-p><a-v>italic</a-v><a-p> = </a-p><a-co>false</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L353" href="#L353">353</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L354" href="#L354">354</a><span class="code-text"><a-p>      </a-p><a-c>-- Specify whether you want the text to be rendered with strikethrough (true)</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L355" href="#L355">355</a><span class="code-text"><a-p>      </a-p><a-c>-- or not for this tab.  The default is false.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L356" href="#L356">356</a><span class="code-text"><a-p>      </a-p><a-v>strikethrough</a-v><a-p> = </a-p><a-co>false</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L357" href="#L357">357</a><span class="code-text"><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="L358" href="#L358">358</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L359" href="#L359">359</a><span class="code-text"><a-p>    </a-p><a-c>-- Inactive tabs are the tabs that do not have focus</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L360" href="#L360">360</a><span class="code-text"><a-p>    </a-p><a-v>inactive_tab</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L361" href="#L361">361</a><span class="code-text"><a-p>      </a-p><a-v>bg_color</a-v><a-p> = </a-p><a-s>&#39;#1b1032&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L362" href="#L362">362</a><span class="code-text"><a-p>      </a-p><a-v>fg_color</a-v><a-p> = </a-p><a-s>&#39;#808080&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L363" href="#L363">363</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L364" href="#L364">364</a><span class="code-text"><a-p>      </a-p><a-c>-- The same options that were listed under the `active_tab` section above</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L365" href="#L365">365</a><span class="code-text"><a-p>      </a-p><a-c>-- can also be used for `inactive_tab`.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L366" href="#L366">366</a><span class="code-text"><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="L367" href="#L367">367</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L368" href="#L368">368</a><span class="code-text"><a-p>    </a-p><a-c>-- You can configure some alternate styling when the mouse pointer</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L369" href="#L369">369</a><span class="code-text"><a-p>    </a-p><a-c>-- moves over inactive tabs</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L370" href="#L370">370</a><span class="code-text"><a-p>    </a-p><a-v>inactive_tab_hover</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L371" href="#L371">371</a><span class="code-text"><a-p>      </a-p><a-v>bg_color</a-v><a-p> = </a-p><a-s>&#39;#3b3052&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L372" href="#L372">372</a><span class="code-text"><a-p>      </a-p><a-v>fg_color</a-v><a-p> = </a-p><a-s>&#39;#909090&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L373" href="#L373">373</a><span class="code-text"><a-p>      </a-p><a-v>italic</a-v><a-p> = </a-p><a-co>true</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L374" href="#L374">374</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L375" href="#L375">375</a><span class="code-text"><a-p>      </a-p><a-c>-- The same options that were listed under the `active_tab` section above</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L376" href="#L376">376</a><span class="code-text"><a-p>      </a-p><a-c>-- can also be used for `inactive_tab_hover`.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L377" href="#L377">377</a><span class="code-text"><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="L378" href="#L378">378</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L379" href="#L379">379</a><span class="code-text"><a-p>    </a-p><a-c>-- The new tab button that let you create new tabs</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L380" href="#L380">380</a><span class="code-text"><a-p>    </a-p><a-v>new_tab</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L381" href="#L381">381</a><span class="code-text"><a-p>      </a-p><a-v>bg_color</a-v><a-p> = </a-p><a-s>&#39;#1b1032&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L382" href="#L382">382</a><span class="code-text"><a-p>      </a-p><a-v>fg_color</a-v><a-p> = </a-p><a-s>&#39;#808080&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L383" href="#L383">383</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L384" href="#L384">384</a><span class="code-text"><a-p>      </a-p><a-c>-- The same options that were listed under the `active_tab` section above</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L385" href="#L385">385</a><span class="code-text"><a-p>      </a-p><a-c>-- can also be used for `new_tab`.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L386" href="#L386">386</a><span class="code-text"><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="L387" href="#L387">387</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L388" href="#L388">388</a><span class="code-text"><a-p>    </a-p><a-c>-- You can configure some alternate styling when the mouse pointer</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L389" href="#L389">389</a><span class="code-text"><a-p>    </a-p><a-c>-- moves over the new tab button</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L390" href="#L390">390</a><span class="code-text"><a-p>    </a-p><a-v>new_tab_hover</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L391" href="#L391">391</a><span class="code-text"><a-p>      </a-p><a-v>bg_color</a-v><a-p> = </a-p><a-s>&#39;#3b3052&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L392" href="#L392">392</a><span class="code-text"><a-p>      </a-p><a-v>fg_color</a-v><a-p> = </a-p><a-s>&#39;#909090&#39;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L393" href="#L393">393</a><span class="code-text"><a-p>      </a-p><a-v>italic</a-v><a-p> = </a-p><a-co>true</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L394" href="#L394">394</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L395" href="#L395">395</a><span class="code-text"><a-p>      </a-p><a-c>-- The same options that were listed under the `active_tab` section above</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L396" href="#L396">396</a><span class="code-text"><a-p>      </a-p><a-c>-- can also be used for `new_tab_hover`.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L397" href="#L397">397</a><span class="code-text"><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="L398" href="#L398">398</a><span class="code-text"><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="L399" href="#L399">399</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L400" href="#L400">400</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L401" href="#L401">401</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L402" href="#L402">402</a><span class="code-text"><a-p>### </a-p><a-tt>Window Padding</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L403" href="#L403">403</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L404" href="#L404">404</a><span class="code-text"><a-p>You may add padding around the edges of the terminal area.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L405" href="#L405">405</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L406" href="#L406">406</a><span class="code-text"><a-p>[See the window_padding docs for more info](lua/config/window_padding.md)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L407" href="#L407">407</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L408" href="#L408">408</a><span class="code-text"><a-p>## </a-p><a-tt>Styling Inactive Panes</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L409" href="#L409">409</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L410" href="#L410">410</a><span class="code-text"><a-p>{{since(&#39;20201031-154415-9614e117&#39;)}}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L411" href="#L411">411</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L412" href="#L412">412</a><span class="code-text"><a-p>To make it easier to see which pane is active, the inactive panes are dimmed</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L413" href="#L413">413</a><span class="code-text"><a-p>and de-saturated slightly.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L414" href="#L414">414</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L415" href="#L415">415</a><span class="code-text"><a-p>You can specify your own transformation to the pane colors with a hue,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L416" href="#L416">416</a><span class="code-text"><a-p>saturation, brightness (HSB) multiplier.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L417" href="#L417">417</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L418" href="#L418">418</a><span class="code-text"><a-p>In this example, inactive panes will be slightly de-saturated and dimmed;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L419" href="#L419">419</a><span class="code-text"><a-p>this is the default configuration:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L420" href="#L420">420</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L421" href="#L421">421</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="L422" href="#L422">422</a><span class="code-text"><a-p>config.</a-p><a-v>inactive_pane_hsb</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L423" href="#L423">423</a><span class="code-text"><a-p>  </a-p><a-v>saturation</a-v><a-p> = </a-p><a-n>0.9</a-n><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L424" href="#L424">424</a><span class="code-text"><a-p>  </a-p><a-v>brightness</a-v><a-p> = </a-p><a-n>0.8</a-n><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L425" href="#L425">425</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L426" href="#L426">426</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L427" href="#L427">427</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L428" href="#L428">428</a><span class="code-text"><a-p>The transform works by converting the RGB colors to HSV values and</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L429" href="#L429">429</a><span class="code-text"><a-p>then multiplying the HSV by the numbers specified in `inactive_pane_hsb`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L430" href="#L430">430</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L431" href="#L431">431</a><span class="code-text"><a-p>Modifying the hue changes the hue of the color by rotating it through the color</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L432" href="#L432">432</a><span class="code-text"><a-p>wheel. It is not as useful as the other components, but is available &quot;for free&quot;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L433" href="#L433">433</a><span class="code-text"><a-p>as part of the colorspace conversion.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L434" href="#L434">434</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L435" href="#L435">435</a><span class="code-text"><a-p>Modifying the saturation can add or reduce the amount of &quot;colorfulness&quot;. Making</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L436" href="#L436">436</a><span class="code-text"><a-p>the value smaller can make it appear more washed out.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L437" href="#L437">437</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L438" href="#L438">438</a><span class="code-text"><a-p>Modifying the brightness can be used to dim or increase the perceived amount of</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L439" href="#L439">439</a><span class="code-text"><a-p>light.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L440" href="#L440">440</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L441" href="#L441">441</a><span class="code-text"><a-p>The range of these values is 0.0 and up; they are used to multiply the existing</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L442" href="#L442">442</a><span class="code-text"><a-p>values, so the default of 1.0 preserves the existing component, whilst 0.5 will</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L443" href="#L443">443</a><span class="code-text"><a-p>reduce it by half, and 2.0 will double the value.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L444" href="#L444">444</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L445" href="#L445">445</a><span class="code-text"><a-p>## </a-p><a-tt>Window Background Image</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L446" href="#L446">446</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L447" href="#L447">447</a><span class="code-text"><a-p>![Screenshot](../screenshots/wezterm-vday-screenshot.png)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L448" href="#L448">448</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L449" href="#L449">449</a><span class="code-text"><a-p>{{since(&#39;20201031-154415-9614e117&#39;)}}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L450" href="#L450">450</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L451" href="#L451">451</a><span class="code-text"><a-p>You can attach an image to the background of the wezterm window:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L452" href="#L452">452</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L453" href="#L453">453</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="L454" href="#L454">454</a><span class="code-text"><a-p>config.</a-p><a-v>window_background_image</a-v><a-p> = </a-p><a-s>&#39;/path/to/wallpaper.jpg&#39;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L455" href="#L455">455</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L456" href="#L456">456</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L457" href="#L457">457</a><span class="code-text"><a-p>If the path is a relative path then it will be expanded relative</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L458" href="#L458">458</a><span class="code-text"><a-p>to the directory containing your `wezterm.lua` config file.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L459" href="#L459">459</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L460" href="#L460">460</a><span class="code-text"><a-p>PNG, JPEG, GIF, BMP, ICO, TIFF, PNM, DDS, TGA and farbfeld files</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L461" href="#L461">461</a><span class="code-text"><a-p>can be loaded.  Animated GIF and PNG files will animate while</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L462" href="#L462">462</a><span class="code-text"><a-p>the window has focus.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L463" href="#L463">463</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L464" href="#L464">464</a><span class="code-text"><a-p>The image will be scaled to fit the window contents.  Very large</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L465" href="#L465">465</a><span class="code-text"><a-p>images may decrease render performance and take up VRAM from the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L466" href="#L466">466</a><span class="code-text"><a-p>GPU, so you may wish to resize the image file before using it.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L467" href="#L467">467</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L468" href="#L468">468</a><span class="code-text"><a-p>You can optionally transform the background image by specifying</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L469" href="#L469">469</a><span class="code-text"><a-p>a hue, saturation, brightness multiplier:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L470" href="#L470">470</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L471" href="#L471">471</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="L472" href="#L472">472</a><span class="code-text"><a-p>config.</a-p><a-v>window_background_image</a-v><a-p> = </a-p><a-s>&#39;/path/to/wallpaper.jpg&#39;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L473" href="#L473">473</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L474" href="#L474">474</a><span class="code-text"><a-p>config.</a-p><a-v>window_background_image_hsb</a-v><a-p> = </a-p><a-cr>{</a-cr></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L475" href="#L475">475</a><span class="code-text"><a-p>  </a-p><a-c>-- Darken the background image by reducing it to 1/3rd</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L476" href="#L476">476</a><span class="code-text"><a-p>  </a-p><a-v>brightness</a-v><a-p> = </a-p><a-n>0.3</a-n><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L477" href="#L477">477</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L478" href="#L478">478</a><span class="code-text"><a-p>  </a-p><a-c>-- You can adjust the hue by scaling its value.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L479" href="#L479">479</a><span class="code-text"><a-p>  </a-p><a-c>-- a multiplier of 1.0 leaves the value unchanged.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L480" href="#L480">480</a><span class="code-text"><a-p>  </a-p><a-v>hue</a-v><a-p> = </a-p><a-n>1.0</a-n><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L481" href="#L481">481</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L482" href="#L482">482</a><span class="code-text"><a-p>  </a-p><a-c>-- You can adjust the saturation also.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L483" href="#L483">483</a><span class="code-text"><a-p>  </a-p><a-v>saturation</a-v><a-p> = </a-p><a-n>1.0</a-n><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L484" href="#L484">484</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L485" href="#L485">485</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L486" href="#L486">486</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L487" href="#L487">487</a><span class="code-text"><a-p>See [Styling Inactive Panes](#styling-inactive-panes) for more information</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L488" href="#L488">488</a><span class="code-text"><a-p>on hue, saturation, brightness transformations.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L489" href="#L489">489</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L490" href="#L490">490</a><span class="code-text"><a-p>If you&#39;d like to have control over scaling, tiling/repeating, scrolling</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L491" href="#L491">491</a><span class="code-text"><a-p>behavior and more, take a look at the more powerful</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L492" href="#L492">492</a><span class="code-text"><a-p>[background](lua/config/background.md) configuration option.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L493" href="#L493">493</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L494" href="#L494">494</a><span class="code-text"><a-p>## </a-p><a-tt>Window Background Gradient</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L495" href="#L495">495</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L496" href="#L496">496</a><span class="code-text"><a-p>{{since(&#39;20210814-124438-54e29167&#39;)}}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L497" href="#L497">497</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L498" href="#L498">498</a><span class="code-text"><a-p>![Gradient](../screenshots/radial-gradient.png)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L499" href="#L499">499</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L500" href="#L500">500</a><span class="code-text"><a-p>See [window_background_gradient](lua/config/window_background_gradient.md)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L501" href="#L501">501</a><span class="code-text"><a-p>for configuration information on gradients.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L502" href="#L502">502</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L503" href="#L503">503</a><span class="code-text"><a-p>## </a-p><a-tt>Window Background Opacity</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L504" href="#L504">504</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L505" href="#L505">505</a><span class="code-text"><a-p>{{since(&#39;20201031-154415-9614e117&#39;)}}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L506" href="#L506">506</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L507" href="#L507">507</a><span class="code-text"><a-p>If your Operating System provides Compositing support then WezTerm is able to</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L508" href="#L508">508</a><span class="code-text"><a-p>specify the alpha channel value for the background content, rendering the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L509" href="#L509">509</a><span class="code-text"><a-p>window background translucent (some refer to this as transparent rather than</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L510" href="#L510">510</a><span class="code-text"><a-p>translucent) and causing the windows/desktop behind it to show through the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L511" href="#L511">511</a><span class="code-text"><a-p>window.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L512" href="#L512">512</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L513" href="#L513">513</a><span class="code-text"><a-p>macOS, Windows and Wayland support compositing out of the box. X11 may require</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L514" href="#L514">514</a><span class="code-text"><a-p>installing or configuring a compositing window manager. XWayland under</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L515" href="#L515">515</a><span class="code-text"><a-p>Mutter/Wayland also works without any additional configuration.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L516" href="#L516">516</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L517" href="#L517">517</a><span class="code-text"><a-p>`window_background_opacity` specifies the alpha channel value</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L518" href="#L518">518</a><span class="code-text"><a-p>with floating point numbers in the range `0.0` (meaning completely</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L519" href="#L519">519</a><span class="code-text"><a-p>translucent/transparent) through to `1.0` (meaning completely opaque).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L520" href="#L520">520</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L521" href="#L521">521</a><span class="code-text"><a-p>Setting this to a value other than the default `1.0` may impact render</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L522" href="#L522">522</a><span class="code-text"><a-p>performance.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L523" href="#L523">523</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L524" href="#L524">524</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="L525" href="#L525">525</a><span class="code-text"><a-p>config.</a-p><a-v>window_background_opacity</a-v><a-p> = </a-p><a-n>1.0</a-n></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L526" href="#L526">526</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L527" href="#L527">527</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L528" href="#L528">528</a><span class="code-text"><a-p>## </a-p><a-tt>Text Background Opacity</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L529" href="#L529">529</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L530" href="#L530">530</a><span class="code-text"><a-p>{{since(&#39;20201031-154415-9614e117&#39;)}}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L531" href="#L531">531</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L532" href="#L532">532</a><span class="code-text"><a-p>When using a background image or background opacity, the image content can</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L533" href="#L533">533</a><span class="code-text"><a-p>have relatively low contrast with respect to the text you are trying to</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L534" href="#L534">534</a><span class="code-text"><a-p>read in your terminal.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L535" href="#L535">535</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L536" href="#L536">536</a><span class="code-text"><a-p>The `text_background_opacity` setting specifies the alpha channel value to use</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L537" href="#L537">537</a><span class="code-text"><a-p>for the background color of cells other than the default background color.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L538" href="#L538">538</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L539" href="#L539">539</a><span class="code-text"><a-p>The default for this setting is `1.0`, which means that the background</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L540" href="#L540">540</a><span class="code-text"><a-p>color is fully opaque.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L541" href="#L541">541</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L542" href="#L542">542</a><span class="code-text"><a-p>The range of values permitted are `0.0` (completely translucent)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L543" href="#L543">543</a><span class="code-text"><a-p>through to `1.0` (completely opaque).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L544" href="#L544">544</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L545" href="#L545">545</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="L546" href="#L546">546</a><span class="code-text"><a-p>config.</a-p><a-v>text_background_opacity</a-v><a-p> = </a-p><a-n>0.3</a-n></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L547" href="#L547">547</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L548" href="#L548">548</a><span class="code-text"></span></span></pre></div></div>
</main>
</body>
</html>
