Skip to main content
The -list-themes command displays all built-in color themes that come pre-installed with Termy.

​
Usage

termy-cli -list-themes

​
What It Does

This command queries Termy’s theme registry and outputs a list of all available theme identifiers that you can use in your configuration.

​
Example Output

ayu-dark
ayu-light
ayu-mirage
catppuccin-frappe
catppuccin-latte
catppuccin-macchiato
catppuccin-mocha
dracula
gruvbox-dark
gruvbox-light
nord
one-dark
one-light
solarized-dark
solarized-light
termy
tokyo-night
tokyo-night-storm
Theme names are lowercase and use hyphens as separators. These exact identifiers must be used in your configuration file.

​
Built-in Themes

Termy includes carefully curated themes optimized for terminal use:
ThemeDescriptionVariant
termyTermy’s custom themeDark
draculaPopular purple-based themeDark
nordArctic, north-bluish themeDark
one-darkAtom’s iconic themeDark
one-lightAtom’s light variantLight
tokyo-nightClean, modern themeDark
tokyo-night-stormStorm variantDark
catppuccin-mochaSoothing pastel themeDark
catppuccin-macchiatoMid-tone variantDark
catppuccin-frappeFrappe variantDark
catppuccin-latteLight variantLight
gruvbox-darkRetro groove colorsDark
gruvbox-lightRetro groove lightLight
solarized-darkPrecision colorsDark
solarized-lightPrecision lightLight
ayu-darkModern syntax themeDark
ayu-mirageMirage variantDark
ayu-lightLight variantLight

​
Viewing Theme Colors

After finding a theme, inspect its color palette: 
# View colors for your active theme
termy-cli -list-colors
See List Colors for more details.

​
Configuring Themes

Set your preferred theme in the configuration file:
1

Open configuration

termy-cli -edit-config
2

Set theme

theme = "nord"
3

Validate configuration

termy-cli -validate-config
4

Restart Termy

Theme changes require restarting Termy to take effect.

​
Use Cases

​
Finding a Theme

Search for specific themes: 
termy-cli -list-themes | grep -i "catppuccin"

​
Counting Themes

See how many themes are available: 
termy-cli -list-themes | wc -l

​
Exporting Theme List

Save themes to a file: 
termy-cli -list-themes > available-themes.txt

​
Scripting Theme Selection

Randomly select a theme: 
#!/bin/bash
theme=$(termy-cli -list-themes | shuf -n 1)
echo "Selected theme: $theme"
# Update config programmatically

​
Theme Selection Tips

  • Bright environments: Light themes (one-light, solarized-light, gruvbox-light)
  • Dim environments: Dark themes (nord, dracula, tokyo-night)
  • Variable lighting: Themes with both variants (ayu, gruvbox, catppuccin)
  • Blue tones: nord, tokyo-night
  • Purple tones: dracula, catppuccin
  • Warm tones: gruvbox, ayu
  • Neutral: one-dark, termy
  • High contrast: dracula, one-dark
  • Medium contrast: nord, tokyo-night
  • Low contrast: gruvbox, solarized

​
Custom Themes

While -list-themes only shows built-in themes, you can create custom themes by defining colors in your configuration: 
theme = "my-custom-theme"

[colors]
foreground = "#e0e0e0"
background = "#1a1a1a"
cursor = "#00ff00"

# ANSI colors
black = "#1a1a1a"
red = "#ff5555"
green = "#50fa7b"
yellow = "#f1fa8c"
blue = "#bd93f9"
magenta = "#ff79c6"
cyan = "#8be9fd"
white = "#f8f8f2"
# ... bright variants
Custom themes won’t appear in -list-themes output since they’re user-defined, not built-in.

​
Validation

Always validate your configuration after changing themes: 
termy-cli -validate-config
This ensures:
  • Theme name is recognized (if using built-in)
  • Custom color values are valid hex codes
  • No syntax errors in the config file

​
Theme Files

Built-in themes are compiled into Termy and sourced from the termy_themes crate. You cannot modify built-in themes, but you can:
  1. Use them as-is by name
  2. Create custom themes with your own colors
  3. Override specific colors while using a base theme

List Colors

View color palette for active theme

Show Config

See your current theme setting

Interactive TUI

Browse themes visually

Theme Configuration

Complete theme configuration guide

Build docs developers (and LLMs) love

Get started for freeTalk to us