Theme format · version 1

Theme your file manager with files.toml.

Semantic colors that an Omarchy theme can define once and other file managers can choose to implement.

01 · Location

Keep it with the Omarchy theme.

Add files.toml beside the active theme's colors.toml. Teral watches the active theme and applies changes while running.

~/.config/omarchy/current/theme/files.toml

02 · Complete example

Start with the roles you need.

Every color and layout key is optional. Declare version = 1, define the values the theme owns, and let Teral inherit the rest safely.

files.toml

version = 1
name = "Amber Circuit"

[colors]
background = "#0d0d0f"
surface = "#101014"
surface_alt = "#19191f"
elevated = "#202028"
border = "#2d2b30"
text = "#d9d4cb"
text_bright = "#fff7e8"
text_muted = "#858078"
accent = "#e6a843"
selection = "#352817"
danger = "#df6653"
warning = "#e6a843"
success = "#7dbb7a"

[layout]
window_width = 1360
window_height = 840
sidebar_width = 238
details_width = 316
spacing = 12
radius = 10
row_height = 30
grid_icon_size = 64

03 · Portable color roles

Meaning, not GTK internals.

The color section is the portable core. The names describe interface purpose so another file manager can support the same contract.

backgroundWindow canvas

surfacePrimary panels

surface_altContrasting regions

elevatedMenus and raised controls

borderDividers and outlines

textPrimary readable text

text_brightStrong labels and focus

text_mutedSecondary information

accentActive controls and identity

selectionSelected rows and tiles

dangerDestructive actions

warningCaution and attention

successCompleted and healthy states

04 · Optional Teral layout

Controlled, and safely bounded.

The layout section is currently a Teral extension. Values outside these ranges are clamped rather than allowed to break the interface.

window_width720–3840 px

window_height480–2160 px

sidebar_width180–420 px

details_width240–520 px

spacing0–32 px

radius0–24 px

row_height22–64 px

grid_icon_size32–160 px

05 · Fallback behavior

Partial themes remain usable.

When files.toml is missing, Teral derives a palette from Omarchy's colors.toml. Missing or invalid individual values inherit from the safe built-in palette. Outside Omarchy, system mode follows GTK.