Themes

The Perceptron TUI includes a built-in theme editor and some pre-installed themes. All themes use a 14-color palette.

Built-in Themes

The following themes are installed by default:

Theme Editor

Open the theme editor from the Settings page by selecting “Configure Theme”. The editor displays all 14 color fields of the currently active theme as editable hex values with live preview swatches.

FieldDefaultPurpose
Background#1e1e2eMain background (leave empty for a transparent background)
Primary#cba6f7Focused/editing borders, active elements
Secondary#cdd6f4Data values, table rows
Success#a6e3a1Connected status, positive states
Error#f38ba8Failed states, errors
Warning#f9e2afPending states, cautions
Muted#7f849cInactive sidebar items, key hints
Surface#45475aInactive borders, separators
Accent#74c7ecAddresses, links, highlights
Text#bac2deForm titles, section headers
Highlight#fab387Table headers, active items
Dim#585b70Placeholder text, disabled elements
Mantle#181825Modal/popup background
Crust#11111bDeepest background layer

Editing a Theme

  1. Open the theme editor from the Settings page
  2. Edit any color field (hex format, e.g. #ff00aa)
  3. Press the “Save Theme” button at the bottom of the page
  4. The theme is saved as custom.json in ~/.perceptron/themes/

Loading a Theme

  1. In the Theme Editor, press the “Load Theme” button
  2. Select a theme from the list
  3. The theme is applied immediately

Creating Custom Themes

Themes are stored as JSON files in ~/.perceptron/themes/. Each file contains the 14 color hexadecimal fields:

{
  "background": "#1e1e2e",
  "primary": "#cba6f7",
  "secondary": "#cdd6f4",
  "success": "#a6e3a1",
  "error": "#f38ba8",
  "warning": "#f9e2af",
  "muted": "#7f849c",
  "surface": "#45475a",
  "accent": "#74c7ec",
  "text": "#bac2de",
  "highlight": "#fab387",
  "dim": "#585b70",
  "mantle": "#181825",
  "crust": "#11111b"
}

The background field can be empty ("") to use the terminal’s default background color (transparent).