Tinted Terminal

Tinted terminal is a Tinted Theming terminal template repository containing Base16, Base24 and Tinted8 terminal theme files for various terminal emulators. Below is a table of contents, which includes a list of supported terminal emulators with links to their installation instructions:

• Alacritty
• ConEmu
• Foot
• Ghostty
• iTerm2
• Kermit
• Kitty
• Konsole
• Mintty
• PuTTY
• QTerminal
• st
• Rio
• Termite
• WezTerm
• xfce4

Have a look at the Tinted Theming Gallery for examples of theme colors.

Tinted Terminal Background

This repository consolidates various terminal template repositories into a single location, making them easier to maintain, especially since terminal themes primarily adhere to the standard ANSI color styling with limited additional customization options.

256-color themes

By default, the themes in the themes/ directory are designed for terminals that support setting 256 ANSI colors.

These themes reuse 6 of the Base16 scheme colors twice: once for the normal color variants (Red, Green, Yellow, Blue, etc) and again for bright variants (Bright Red, Bright Green, Bright Yellow, Bright Blue, etc). Base24 enables unique color values for the bright color variants.

However, this approach leaves 6 colors from the Base16 scheme unused in the terminal palette. To address this, we map these unused colors to the extended ANSI color slots (16–21). This ensures that terminal app creators can access the full set of colors when creating ANSI-color passthrough themes.

16-color themes

Some terminals do not support extended ANSI-256 colors. In these cases, Tinted Terminal themes only set the first 16 ANSI colors and ANSI colors 16-21 remain the default shades of blue. These 16-color Tinted Termianl themes are located in the themes-16/ directory.

For most users, there is no noticeable difference between the 256-color and 16-color themes unless they are using CLI tool themes that specifically rely on tinted-terminal's ANSI colors 16–21.

If you are using an ANSI passthrough theme that requires Tinted Terminal ANSI colors 16–21, but you are using a terminal that does not support setting these values, you can use tinted-shell to shim the missing ANSI colors.

Basic Tinty Usage Instructions

There are Tinty installation steps in the installation instructions for most of the terminals. This will contain slightly more information about it adding a Tinted Terminal theme to Tinty.

1. Add the following toml settings to your Tinty ~/.config/tinted-theming/tinty/config.toml file:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-terminal"
   themes-dir = "themes/alacritty" # Directory name of terminal theme you want to use
   supported-systems = ["base16", "base24"]
   

2. tinty apply base16-ayu-dark will create a theme file at ~/.local/share/tinted-theming/tinty/tinted-terminal-alacritty-file.toml where tinted-terminal-alacritty-file.toml is made up of <NAME>-<THEMES_DIR>-file.<FILE_EXTENSION>:

   • <NAME> - The name property in ...tinty/config.toml
   • <THEMES_DIR> - The themes-dir property in ...tinty/config.toml
   • <FILE_EXTENSION> - The file extension of the theme file set by the template

For more information on Tinty setup or usage, have a look at the Tinty GitHub page.

Alacritty

Tinted Theming template for Alacritty terminal emulator.

Theme directory: themes/alacritty/

Tinty

1. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-terminal"
   themes-dir = "themes/alacritty"
   hook = "cp -f %f ~/.config/alacritty/colors.toml && touch ~/.config/alacritty/alacritty.toml"
   supported-systems = ["base16", "base24"]
   

2. Add the following to ~/.config/alacritty/alacritty.toml:

   import = ["~/.config/alacritty/colors.toml"]
   

3. tinty apply base16-ayu-dark to change the theme to base16-ayu-dark

For more information on Tinty setup or usage, have a look at the Tinty GitHub page.

Manual

After cloning this repo, simply copy the contents of your desired theme into your alacritty.yml configuration file. Make sure to remove or comment out any previous theme.

ConEmu

Tinted Theming template for ConEmu terminal emulator.

Theme directory: themes/conemu/

PowerShell install-script

The script will always create a backup of your config file as ConEmu.backup.xml prior to doing anything. It's got two operation modes:

Add theme

1. Run:

   .\scripts\Install-ConEmuTheme.ps1 [-ConfigPath Path] -Operation Add -ThemePathOrName .\themes\base16-twilight.xml
   

2. Restart ConEmu and activate the color theme in ConEmu Settings -> Features -> Colors using the Schemes drop-down.

Remove theme

.\scripts\Install-ConEmuTheme.ps1 [-ConfigPath Path] -Operation Remove -ThemePathOrName "base16-twilight"

Note: -ConfigPath argument is optional if your ConEmu.xml is located at the default location C:\Users\You\AppData\Roaming\ConEmu.xml.

Manual

1. Open ConEmu.xml. Usually it is at ~\AppData\Roaming, where ~ is your home directory (C:\Users\UserName).

2. Paste the color scheme at the end of palette settings part. It starts with the following:

   <key name="Colors" modified="2015-03-19 13:53:09" build="150310">
      <value name="Count" type="dword" data="00000001"/>
   <key name="Palette1" modified="2015-03-19 13:53:09" build="150310">
   

3. If you do not have any custom color scheme, the xml key is not there. In ConEmu, go to Settings -> Feature -> Colors and generate a custom color theme by click on Save button and specify any name. Then Colors key will be automatically generated in your ConEmu.xml. You can overwrite it when you add new themes.

4. Update the palette number (key name PaletteX) accordingly. For example, if you have 1 custom color palette already, it should be Palette2 for the new one:

   <key name="Palette2" modified="2015-03-19 13:53:09" build="150310">
   

5. Make sure to increase the value for key name Count under key Colors as well. It should equal to the total number of pallets you have:

   <value name="Count" type="dword" data="00000002"/>
   

6. For example, the Colors part of your modified ConEmu.xml should look like this:

   <key name="Colors" modified="2015-03-19 13:53:09" build="150310">
       <value name="Count" type="dword" data="00000002"/>
       <key name="Palette1" modified="2015-03-19 13:53:09" build="150310">
           <value name="Name" type="string" data="EXISTING COLOR"/>
           <value name="ExtendColors" type="hex" data="00"/>
           ...
           <value name="ColorTable31" type="dword" data="00e3f6fd"/>
       </key>
       <key name="Palette2" modified="2015-03-19 13:53:09" build="150310">
           <value name="Name" type="string" data="NAME OF THE COLOR YOU ADDED"/>
           <value name="ExtendColors" type="hex" data="01"/>
           ...
           <value name="ColorTable31" type="dword" data="00e7fdfd"/>
       </key>
   </key>
   

Also, make sure that all the color options set to Auto to get correct highlighting:

Color mapping

To see the current colors, run this PowerShell script:

[enum]::GetValues([System.ConsoleColor]) | Foreach-Object {Write-Host $_ -ForegroundColor $_}

Attribution

Install-ConEmuTheme.ps1 and the installation instructions are based on https://github.com/joonro/ConEmu-Color-Themes

Foot

Tinted Theming template for Foot terminal emulator.

Theme directory: themes/foot/

Tinty

If you use Tinty to apply your themes, complete the following steps to update your theme when running tinty apply base16-ayu-dark (where base16-ayu-dark is a placeholder scheme name):

1. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-terminal"
   themes-dir = "themes/foot"
   supported-systems = ["base16", "base24"]
   

2. Add the following to $HOME/.config/foot/foot.ini:

   include=~/.local/share/tinted-theming/tinty/tinted-terminal-themes-foot-file.ini
   

3. tinty apply base16-ayu-dark to change the theme to base16-ayu-dark

For more information on Tinty setup or usage, have a look at the Tinty GitHub page.

Manual

Clone this repo to reference the colorschemes.

git clone https://github.com/tinted-theming/tinted-terminal.git "/path/to/tinted-terminal"

Include the following in your theme in your foot.ini (usually stored at $HOME/.config/foot/foot.ini) under [main], or the untitled section at the beginning of the file.

include=/path/to/tinted-terminal/themes/foot/base16-ayu-dark.ini

Ghostty

Tinted theming template for Ghostty

Manual

Ghostty can auto-discover theme files located in the following directories:

1. $XDG_CONFIG_HOME/ghostty/themes
2. $PREFIX/share/ghostty/themes

You can simply download the theme you like into one of these directories and refer to it by filename in your main Ghostty config, like so:

theme = base16-ayu-dark

Tinty

1. Make sure this directory exists:

   mkdir -p ~/.config/ghostty/themes
   

2. Add the following to ~/.config/ghostty/config:

   # Set `theme` to "tinted-theming":
   theme = "tinted-theming"
   

3. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-terminal"
   themes-dir = "themes/ghostty"
   # With `theme` set to "tinted-theming", this will be where Ghostty looks for the theme file:
   hook = """
   mkdir -p ~/.config/ghostty/themes
   command cp -f "$TINTY_THEME_FILE_PATH" ~/.config/ghostty/themes/tinted-theming
   killall -SIGUSR2 ghostty 2>/dev/null || true
   """
   supported-systems = ["base16", "base24"]
   

4. tinty apply base16-ayu-dark to change the theme to base16-ayu-dark.

macOS

 Customize Ghostty's app icon

By default, the theme files assigns Bright White and Bright Blue for the icon's ghost tint and screen tint, respectively. If you'd like to use different colors, this repository provides scripts to generate a theme file with the icon & screen tints you prefer. They are located in ./themes/ghostty-scripts and can be used as follows:

Manual

# Example:
sh /path/to/tinted-terminal/themes/ghostty-scripts/base16-ayu-dark.sh \
   -g 5 \
   -s 16,12,10 \
   >! ~/.config/ghostty/themes/base16-ayu-dark

The above example would generate a base16-ayu-dark theme with macos-icon-ghost-color set to palette[5] color, and macos-icon-screen-color set to a gradient of palette[16], palette[12], and palette[10].

Tinty

Follow the same Tinty instructions, but put this in ~/.config/tinted-theming/tinty/config.toml instead for Step 2:

[[items]]
path = "https://github.com/tinted-theming/tinted-terminal"
name = "tinted-terminal"
themes-dir = "themes/ghostty-scripts"
# With `theme` set to "tinted-theming", this will be where Ghostty looks for the theme file:
hook = '''
sh %f \
   -g 5 \
   -s 16,12,10 \
   >! ~/.config/ghostty/themes/tinted-theming
'''
supported-systems = ["base16", "base24"]

Don’t forget to have this line on your main Ghostty configuration:

macos-icon = custom-style

iTerm2

Tinted Theming template for iTerm2 terminal emulator.

There are two types of theme files for iTerm2:

1. Standard themes which can be imported from iTerm2 itself, instructions below under "Manual".
2. Applescripts that can be executed to change the iTerm2 theme.

Theme directory: themes/iterm2/

Applescripts directory: themes-16/iterm2-applescripts/

Tinty

1. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-terminal"
   themes-dir = "themes-16/iterm2-applescripts"
   hook = '''
   command cp -f %f ~/Library/Application\ Support/iTerm2/Scripts/AutoLaunch.scpt \
     && osascript %f
   '''
   supported-systems = ["base16", "base24"]
   

2. tinty apply base16-ayu-dark to change the theme to base16-ayu-dark

[!NOTE]

This also adds an item under the Scripts menu-bar item that can be invoked to re-apply the theme. You should be able to map a keyboard shortcut to trigger this as you like.

[!IMPORTANT]

The AutoLaunch script is only ran at iTerm2 startup. It will not run when opening new windows or tabs. You may want to add the following line in your rc file:

# Only run if the shell is running in iTerm2.
if [ "$TERM_PROGRAM" = "iTerm.app" ]; then
    osascript "~/Library/Application Support/iTerm2/Scripts/AutoLaunch.scpt"
fi

Manual

1. Open Preferences > Profiles > Colors or ⌘ + i > Colors
2. Click on Color Presets > Import and import your favorite theme from this repo
3. Load the theme by clicking on Color Presets and selecting it

Kermit

Tinted Theming template for VTE-based Kermit terminal emulator.

Theme directory: themes-16/kermit/

Tinty

If you use Tinty to set your themes, complete the following steps to update your theme when running tinty apply base16-default-dark (where base16-default-dark is a placeholder scheme name):

1. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-terminal"
   themes-dir = "themes-16/kermit"
   hook = "cp -f %f ~/.config/kermit.conf"
   supported-systems = ["base16", "base24"]
   

2. tinty apply base16-ayu-dark to change the theme to base16-ayu-dark

Manual

curl https://raw.githubusercontent.com/tinted-theming/tinted-kermit-terminal/main/themes/base16-default-dark.config > ~/.config/kermit.conf

Kitty

Tinted Theming template for Kitty terminal emulator.

Kitty will need to be restarted for changes to take effect. It is possible to remotely trigger a conf-reload, but this requires kitty be started with the feature allow_remote_control=yes.

kitty -o allow_remote_control=yes

Tinty

1. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-terminal"
   themes-dir = "themes/kitty"
   hook = "[ -n \"$KITTY_PID\" ] && kill -USR1 \"$KITTY_PID\""
   supported-systems = ["base16", "base24"]
   

2. Add the following to $HOME/.config/kitty/kitty.conf:

   include ~/.local/share/tinted-theming/tinty/tinted-terminal-themes-kitty-file.conf
   

3. tinty apply base16-ayu-dark to change the theme to base16-ayu-dark

Note: If you don't have the Kitty feature allow_remote_control enabled, Kitty should be manually restarted after using tinty apply to set a new theme for it to take effect.

Manual

Simply copy the contents of your desired color scheme into your kitty configuration (kitty.conf). If you already have a color scheme defined, remove it or comment it out before importing the new scheme.

Alternatively, you can include the theme conf file directly in $HOME/.config/kitty/kitty.conf:

include /path/to/tinted-terminal/themes/kitty/base16-ayu-dark.conf

Konsole

Tinted Theming template for Konsole terminal emulator.

Theme directory: themes/konsole/

Tinty

1. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-terminal"
   themes-dir = "themes/konsole"
   hook = "cp -f %f ~/.local/share/konsole/%n.colorscheme && konsoleprofile ColorScheme=%n"
   supported-systems = ["base16", "base24"]
   

2. tinty apply base16-ayu-dark to change the theme to base16-ayu-dark

For more information on Tinty setup or usage, have a look at the Tinty GitHub page.

Manual

1. Copy the desired theme file to ~/.local/share/konsole/:

   cp themes/konsole/base16-ayu-dark.colorscheme ~/.local/share/konsole/
   

2. In Konsole, go to Settings → Edit Current Profile → Appearance

3. Select the color scheme from the dropdown

Mintty

Tinted Theming template for Mintty terminal emulator.

Theme directory: themes/mintty/

This project provides .mintheme files for configuring Mintty colors according to the base16 system and base24 system.

Manual

1. Choose your theme from the Tinted Theming Gallery;

2. Locate the corresponding file in mintty directory and download it;

3. Edit you .minttyrc file (usually located in your home directory ~/.minttyrc or $APPDATA/mintty/config, ~/.config/mintty/config) and add the following line:

   ThemeFile=absolute/path/to/your/downloaded/theme-file.mintheme
   

4. Save the file; close and reopen Mintty.

PuTTY

Tinted Theming template for PuTTY terminal emulator.

Theme directory: themes/putty/

This project provides .reg files for configuring PuTTY colors according to the base16 system and base24 system.

This repo was originally named base16-putty, but since we've now got the added Base24 template and theme support, and maybe different ones in future, we renamed to tinted-putty so we don't lock ourselves into a single scheme system.

Manual

1. Make sure to have the most recent stable version of PuTTY;
2. Make sure that your version is configured to provide 256 colors support;
3. Choose your theme from the Tinted Theming Gallery;
4. Locate the corresponding file in putty directory and download it;
5. Edit the file, and change session name in [HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\Sessions\ {{SESSION_NAME}} ] to the session you would like to apply the theme;
6. Run the file and accept it to make changes in Windows Registry.

QTerminal

Tinted Theming template for QTerminal terminal emulator.

Theme directory: themes/qterminal/

Tinty

1. Make sure the following directory exists:

   mkdir -p ~/.local/share/qterminal/color-schemes
   

2. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   hook = "cp -f %f ~/.local/share/qterminal/color-schemes/tinty.colorscheme"
   name = "tinted-terminal"
   path = "https://github.com/tinted-theming/tinted-terminal"
   supported-systems = ["base16", "base24"]
   themes-dir = "themes/qterminal"
   

3. Run tinty apply <theme-of-choice> to change the theme.

4. In a QTerminal window goto: File > Preferences... > Appearance, set Color scheme to tinty, and then click the Apply button.

5. Close and reopen QTerminal.

Manual

1. Clone this repository to a location of your choice.

2. Make sure the following directory exists:

   mkdir -p ~/.local/share/qterminal/color-schemes
   

3. Copy the desired theme from the themes/qterminal directory into the directory created in the prior step.

4. In a QTerminal window goto: File > Preferences... > Appearance, set Color scheme to tinty, and then click the Apply button.

5. Close and reopen QTerminal.

Rio

Tinted Theming template for Rio terminal emulator.

Theme directory: themes-16/rio/

Tinty

1. Clone the tinted-terminal themes and symlink to Rio themes directory:

   git clone https://github.com/tinted-theming/tinted-terminal /path/to/tinted-terminal
   ln -s /path/to/tinted-terminal/rio ~/.config/rio/themes
   

2. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "/path/to/tinted-terminal"
   name = "tinted-terminal"
   themes-dir = "themes-16/rio"
   hook = "sed -i 's/theme = \"[^\"]*\"/theme = \"%n\"/' ~/.config/rio/config.toml"
   supported-systems = ["base16", "base24"]
   

3. Add the following to ~/.config/rio/config.toml:

   themes = "base16-default-dark"
   

4. tinty apply base16-ayu-dark to change the theme to base16-ayu-dark

For more information on Tinty setup or usage, have a look at the Tinty GitHub page.

Manual

Copy the contents of your desired theme into your ~/.config/rio/config.toml configuration file. Make sure to remove or comment out any previous theme.

st

Tinted Theming template for st terminal emulator.

Theme directory: themes/st/

Manual

Patch your local copy of the st terminal using the patch or git apply command.

# Example
cd st-0.9.3
patch -p1 < path/to/st-base16-default-dark-0.9.3.diff

Tinty

No support. As an alternative, use xresources patch in combination with tinted-theming/tinted-xresources.

Termite

Tinted Theming template for Termite terminal emulator.

Theme directory: themes/termite/

tinted-termite provides a simple template that can be used with the Base16 and Base24 color schemes to generate a functional config file for thestinger/termite, a keyboard-centric VTE-based terminal.

To use, you can copy one of the config files in themes/ or use curl:

mkdir -p ~/.config/termite
curl https://raw.githubusercontent.com/tinted-theming/tinted-terminal/main/termite/base16-default-dark.config >> ~/.config/termite/config

Warp

Tinted Theming template for Warp terminal emulator.

Theme directory: [themes/warp/]

Config directory:

• Linux: ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/
• Mac: $HOME/.warp/
• Windows: $env:APPDATA\warp\Warp\data\

Manual

git clone https://github.com/tinted-theming/tinted-terminal.git "/path/to/tinted-terminal"

# Create the themes directory if it doesn't exist:
mkdir -p $config_theme_dir # Look at config dir for your operating system
ln -s /path/to/tinted-terminal/themes/warp $config_dir/themes

Open Warp, press Cmd+Shift+P, navigate to Settings → Appearance, and select "Current Theme" and search for "Base16 Ayu Dark" from the available themes.

WezTerm

Tinted Theming template for WezTerm terminal emulator.

Theme directory: [themes/wezterm/]

Tinty

1. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-wezterm"
   themes-dir = "themes/wezterm"
   supported-systems = ["base16", "base24"]
   # Touch wezterm.lua to trigger config auto-reload.
   hook = """
   SRC=$HOME/.local/share/tinted-theming/tinty/repos/tinted-wezterm/themes/wezterm
   WEZTERM_DIR="$HOME/.config/wezterm"
   if [ -d "$SRC" ]; then
       mkdir -p "$WEZTERM_DIR"
       ln -sfn "$SRC" "$WEZTERM_DIR/colors"
       touch -c "$WEZTERM_DIR/wezterm.lua"
   fi
   """
   

2. Add theme-selection logic to your ~/.config/wezterm/wezterm.lua. WezTerm needs to read Tinty's current scheme and set config.color_scheme from it:

   local function read_file(path)
     local f = io.open(path, "r")
     if not f then return nil end
     local s = f:read("*l")
     f:close()
     return s
   end
   
   local scheme = read_file(os.getenv("HOME") .. "/.local/share/tinted-theming/tinty/artifacts/current_scheme")
   -- The config for wezterm
   config.color_scheme = scheme or "base16-ayu-dark"
   

3. tinty apply base16-ayu-dark to change the theme to base16-ayu-dark

Manual

1. Clone this repo locally
2. ln -s /path/to/tinted-terminal/themes/wezterm ~/.config/wezterm/colors
3. Add the theme name to your wezterm.lua file:

    color_scheme = "base16-ayu-dark",
   

xfce4

Tinted Theming template for xfce4 terminal emulator.

Theme directory: themes/xfce4/

Tinty

1. Add the following to ~/.config/tinted-theming/tinty/config.toml:

   [[items]]
   path = "https://github.com/tinted-theming/tinted-terminal"
   name = "tinted-xfce4-terminal"
   themes-dir = "themes/xfce4"
   hook = """
   mkdir -p $XDG_CONFIG_HOME/xfce4/terminal/colorschemes
   cat %f > $XDG_CONFIG_HOME/xfce4/terminal/colorschemes/%n.theme
   """
   supported-systems = ["base16", "base24"]
   

2. tinty sync && tinty apply base16-ayu-dark to change the theme to base16-ayu-dark

3. The theme will be available under Preferences > Colors > Presets.

For more information on Tinty setup or usage, have a look at the Tinty GitHub page.

Manual

Put the prebuilt *.theme files from colorschemes/ into ~/.local/share/xfce4/terminal/colorschemes/ (create this directory if it does not exist), and the themes will be available under Preferences > Colors > Presets.

mkdir -p ~/.local/share/xfce4/terminal
cp -r /path/to/tinted-xfce-terminal/colorschemes ~/.local/share/xfce4/terminal

Contributing

Have a look at the Contributing document for more information.

Credits

This repo was created by merging in the now archived repositories:

• Alacritty
• ConEmu
• Foot
• iTerm2
• Kermit
• Kitty
• PuTTY
• Rio
• Termite
• xfce4

Thanks to @mk12 for consulting on some of the history of base16 terminal template decisions.